Tarification et facturation

Les Hugging Face Jobs vous permettent d’exécuter des tâches de calcul sur l’infrastructure Hugging Face sans avoir à la gérer vous-même. Il suffit de définir une commande, une image Docker et un type de matériel parmi diverses options CPU et GPU.

Les Jobs sont disponibles pour tout utilisateur ou toute organisation disposant d'un solde de crédits positif. Les crédits de calcul mensuels inclus dans un abonnement PRO, Team ou Enterprise sont comptés dans ce solde et peuvent être utilisés pour les Jobs.

La facturation des Jobs est basée sur l'utilisation du matériel et est calculée à la minute : vous êtes facturé pour chaque minute pendant laquelle les Jobs s'exécutent sur le matériel demandé.

Au cours du cycle de vie d’un Job, la facturation n’a lieu que lorsque le Job est en cours de démarrage (Starting) ou en cours d’exécution (Running). Cela signifie qu’il n’y a aucun coût pendant la phase de build.

Si un Job en cours commence à échouer, il est automatiquement suspendu et la facturation cesse.

Tarifs

Les tâches sont facturées à la minute en fonction du matériel utilisé. Par exemple, 10 minutes facturables sur a10g-small coûtent environ 0,17 $ en frais de matériel.

Pour gérer les dépenses, définissez un délai d’expiration, annulez un Job ou consultez votre utilisation actuelle.

CPU

GPU

Vous pouvez également récupérer le matériel disponible et les tarifs de manière programmatique via l’API à l’adresse GET /api/jobs/hardware ou via l’interface en ligne de commande :

>>> hf jobs hardware

Ports exposés

Un Job peut exposer un ou plusieurs ports pour les rendre accessibles de l’extérieur pendant son exécution. L’exposition d’un ou plusieurs ports est facturée à un tarif forfaitaire par Job, en plus du prix du matériel :

Comme le matériel, la facturation est effectuée à la minute, uniquement lorsque le Job est en cours de démarrage ou en cours d'exécution.

Gérer la facturation

Facturation à votre organisation

La facturation est effectuée par défaut dans l’espace de noms de l’utilisateur, mais vous pouvez facturer à votre organisation à la place en spécifiant le namespace approprié :

hf jobs run --namespace my-org-name ...

Dans ce cas, le Job s'exécute sous le compte de l'organisation, et vous pouvez le voir sur la page Jobs de votre organisation (page de l'organisation > paramètres > Jobs).

Sur les plans Enterprise et supérieurs, les administrateurs d’organisation peuvent restreindre qui peut exécuter et consulter les Jobs facturés à l’organisation — aux seuls administrateurs d’organisation ou aux membres de groupes de ressources sélectionnés — via les paramètres Granular feature access.

Facturation à un groupe de ressources

Cette fonctionnalité fait partie de l'offre Enterprise et des offres supérieures.

Si votre organisation a configuré des Resource Groups, vous pouvez attribuer les coûts des tâches à un groupe de ressources spécifique. Pour ce faire :

1. Vous devez être membre du groupe de ressources.
2. Transmettez l’organisation propriétaire du groupe de ressources en tant que namespace, et l’identifiant du groupe de ressources en tant que resource_group_id. Les deux sont obligatoires : un groupe de ressources n’est pris en compte que pour les Jobs facturés à son organisation.

Vous pouvez trouver l’identifiant du groupe de ressources sur la page des paramètres des groupes de ressources de votre organisation.

hf jobs run --namespace my-org-name --resource-group-id <resource-group-id> ...

En Python :

>>> from huggingface_hub import run_job
>>> run_job(
...     image="python:3.12",
...     command=["python", "-c", "print('Hello!')"],
...     namespace="my-org-name",
...     resource_group_id="<resource-group-id>",
... )

Les administrateurs d’organisation et de groupe de ressources peuvent définir des limites de dépenses mensuelles pour les Jobs facturés au groupe.

Afficher l'utilisation actuelle des ressources de calcul

Vous pouvez consulter vos informations de facturation actuelles pour les Jobs sur votre page Billing, dans la section « Compute Usage » :

Des informations supplémentaires sur la facturation sont disponibles dans la documentation dédiée du Hub.

Recommandations

Définir des limites de délai

Définissez un timeout lors de la création du Job pour vous assurer qu’il ne peut pas s’exécuter au-delà d’une certaine durée. L’exécution d’un Job qui atteint la durée du timeout est automatiquement arrêtée, ainsi que sa facturation. Voici comment définir un timeout avec le CLI :

hf jobs run --timeout 3h ...

Notez que le délai d'attente par défaut est fixé à 30 minutes. Vous devez donc spécifier un délai d'attente plus long si votre Job nécessite plus de temps pour s'exécuter.

Annuler les Jobs non pertinents

Si un Job en cours n’est plus pertinent, vous pouvez l’annuler prématurément pour arrêter sa facturation, soit via la page du Job, soit via le CLI :

hf jobs cancel <job-id>