Pricing and Billing

Hugging Face Jobs let you run compute tasks on Hugging Face infrastructure without managing it yourself. Simply define a command, a Docker image, and a hardware flavor among various CPU and GPU options.

Jobs are available to any user or organization with a positive credit balance.

Billing on Jobs is based on hardware usage and is computed by the minute: you get charged for every minute the Jobs runs on the requested hardware.

During a Job’s lifecycle, it is only billed when the Job is Starting or Running. This means that there is no cost during build.

If a running Job starts to fail, it will be automatically suspended and the billing will stop.

Pricing

Jobs are billed per minute based on the hardware used. Below are the available hardware options and their pricing.

CPU

GPU

You can also retrieve available hardware and pricing programmatically via the API at GET /api/jobs/hardware or via the CLI:

>>> hf jobs hardware

Exposed ports

A Job can expose one or more ports to make them reachable from the outside while the Job is running. Exposing one or more ports is billed at a flat rate per Job, in addition to the hardware price:

Like hardware, it is billed by the minute, only while the Job is Starting or Running.

Manage billing

Bill to your organization

Billing is done to the user’s namespace by default, but you can bill to your organization instead by specifying the right namespace:

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

In this case the Job runs under the organization account, and you can see it in your organization Jobs page (organization page > settings > Jobs).

Bill to a resource group

This feature is part of the Enterprise plan and above.

If your organization has Resource Groups set up, you can attribute job costs to a specific resource group. To do so:

1. You must be a member of the resource group.
2. Pass the resource group’s ID as the namespace when running the job.

You can find the resource group’s ID in your organization’s Resource Groups settings page.

hf jobs run --namespace <resource-group-id> ...

In Python:

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

View current compute usage

You can look at your current billing information for Jobs in in your Billing page, under the “Compute Usage” section:

Additional information about billing can be found in the dedicated Hub documentation.

Recommendations

Set timeout limits

Set a timeout when creating the Job to ensure it can’t run beyond a certain duration. A Job run that reaches the timeout duration is automatically stopped, and so is its billing. Here is how to set a timeout with the CLI:

hf jobs run --timeout 3h ...

Note that the default timeout is set to 30 minutes. You must therefore specify a longer timeout if your Job requires more time to run.

Cancel irrelevant Jobs

If a running Job is no longer relevant, you can cancel it prematurely to stop its billing, either via the Job page or the CLI:

hf jobs cancel <job-id>