Preços e Cobranças

Hugging Face Jobs permite executar tarefas de computação na infraestrutura do Hugging Face sem que você precise gerenciá-la. Basta definir um comando, uma imagem Docker e um tipo de hardware entre as diversas opções de CPU e GPU.

Os Jobs estão disponíveis para qualquer usuário ou organização com um saldo de créditos positivo. Os créditos de computação mensais incluídos em uma assinatura PRO, Team ou Enterprise contam para esse saldo e podem ser gastos em Jobs.

A cobrança em Jobs é baseada no uso de hardware e é calculada por minuto: você é cobrado por cada minuto que os Jobs são executados no hardware solicitado.

Durante o ciclo de vida de um Job, ele só é cobrado quando o Job está em estado Starting ou Running. Isso significa que não há custo durante a etapa de build.

Se um Job em execução começar a falhar, ele será suspenso automaticamente e a cobrança será interrompida.

Preços

Os jobs são cobrados por minuto com base no hardware utilizado. Por exemplo, 10 minutos cobráveis em a10g-small custam aproximadamente US$ 0,17 em taxas de hardware.

Para gerenciar os gastos, defina um tempo limite, cancele um Job ou consulte seu uso atual.

CPU

GPU

Você também pode recuperar o hardware disponível e os preços programaticamente por meio da API em GET /api/jobs/hardware ou por meio da CLI:

>>> hf jobs hardware

Portas expostas

Um Job pode expor uma ou mais portas para que elas sejam acessíveis externamente enquanto o Job está em execução. A exposição de uma ou mais portas é cobrada por uma taxa fixa por Job, além do preço do hardware:

Assim como o hardware, a cobrança é feita por minuto, apenas enquanto o Job estiver em estado Starting ou Running.

Gerenciar faturamento

Faturar para sua organização

A faturação é feita, por padrão, no namespace do usuário, mas você pode faturar para sua organização especificando o namespace adequado:

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

Neste caso, o Job é executado sob a conta da organização e você pode visualizá-lo na página de Jobs da sua organização (página da organização > configurações > Jobs).

Nos planos Enterprise e superiores, os administradores da organização podem restringir quem pode executar e visualizar Jobs faturados à organização — apenas administradores da organização ou membros de Grupos de Recursos selecionados — por meio das configurações de Acesso granular a recursos.

Faturar para um grupo de recursos

Este recurso faz parte do plano Enterprise e dos planos superiores.

Se a sua organização tiver Resource Groups configurados, você pode atribuir os custos dos jobs a um grupo de recursos específico. Para isso:

1. Você deve ser um membro do grupo de recursos.
2. Passe a organização que possui o grupo de recursos como namespace e o ID do grupo de recursos como resource_group_id. Ambos são obrigatórios: um grupo de recursos só é considerado para Jobs faturados à sua organização.

Você pode encontrar o ID do grupo de recursos na página de configurações de Grupos de Recursos da sua organização.

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

Em 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>",
... )

Administradores de Organização e de Grupo de Recursos podem definir limites de gastos mensais para Jobs faturados ao grupo.

Visualizar o uso atual de computação

Você pode consultar suas informações de faturamento atuais para Jobs na sua página Billing, na seção “Compute Usage”:

Informações adicionais sobre faturamento podem ser encontradas na documentação dedicada do Hub.

Recomendações

Definir limites de tempo limite

Defina um timeout ao criar o Job para garantir que ele não execute além de uma determinada duração. A execução de um Job que atinge a duração do timeout é interrompida automaticamente, assim como sua cobrança. Aqui está como definir um timeout com a CLI:

hf jobs run --timeout 3h ...

Observe que o tempo limite padrão é definido como 30 minutos. Portanto, você deve especificar um tempo limite maior se o seu Job exigir mais tempo para ser executado.

Cancelar Jobs irrelevantes

Se um Job em execução não for mais relevante, você pode cancelá-lo prematuramente para interromper sua cobrança, seja pela página do Job ou pelo CLI:

hf jobs cancel <job-id>