Início / Guias / Limite gratuito da API de inferência do Hugging Face

Limite gratuito da API de inferência do Hugging Face

O Hugging Face Inference Providers é uma API única para modelos abertos de muitos provedores de inferência. Antes, incluía um pequeno crédito mensal gratuito para cada conta. Hoje, a página oficial de preços não lista crédito mensal para usuários gratuitos. Este guia explica as regras atuais, o erro 402 e as opções gratuitas.

O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.

O limite gratuito atual

A página de preços do Hugging Face para o Inference Providers tem uma tabela de créditos mensais por tipo de conta. Usuários gratuitos não recebem crédito mensal. Eles só podem usar o Inference Providers quando compram créditos ou assinam o PRO.

Créditos mensais do Inference Providers, da página de preços do Hugging Face (verificado em 20 de novembro de 2026)
Tipo de contaCrédito mensalPague conforme o uso
Usuário gratuitoNenhumSim, é preciso comprar crédito
Usuário PRO$2.00Sim
Organização Team ou Enterprise$2.00 por assento, compartilhados na organizaçãoSim
Valor antigo: muitas páginas ainda dizem que usuários gratuitos recebem $0.10 por mês. Esse valor não consta na página oficial de preços hoje. Rastreadores de terceiros registraram a mudança em outubro de 2026. Páginas antigas da documentação do Hugging Face ainda podem mostrar o valor antigo.

Os créditos PRO e Team são créditos gerais de computação. Você também pode gastá-los com Inference Endpoints, hardware de Spaces e Jobs. O Hugging Face cobra a taxa do provedor, sem taxa extra.

Por que você recebe o erro 402

HTTP 402 significa pagamento necessário. No Inference Providers, isso geralmente acontece quando a sua conta não tem mais crédito. Em uma conta gratuita sem crédito comprado, a primeira requisição paga pode devolver 402.

CausaSolução
Conta gratuita sem crédito compradoCompre créditos na página de faturamento, ou assine o PRO
O crédito PRO deste mês foi gastoEspere o próximo mês, ou compre mais créditos
A requisição cobra de uma organização sem créditoRemova o cabeçalho X-HF-Bill-To, ou peça ao administrador da organização para adicionar crédito

Pode ocorrer um erro diferente quando uma organização desativa um provedor. Se você pede esse provedor pelo nome, a requisição falha. Use a seleção automática de provedor ou escolha outro provedor.

Confira o seu uso na página de configurações do Inference Providers. Ela mostra o uso do último mês por modelo e por provedor.

Como a API funciona

  1. Entre no Hugging Face e abra as configurações de token.
  2. Crie um token de granularidade fina.
  3. Dê ao token a permissão "Make calls to Inference Providers".
  4. Guarde o token na variável de ambiente HF_TOKEN.
  5. Compre créditos ou assine o PRO. Sem crédito, uma conta gratuita não consegue concluir requisições pagas.

O Inference Providers tem um endpoint compatível com OpenAI para chat completions em https://router.huggingface.co/v1. Você se autentica com um token de granularidade fina do Hugging Face que tenha permissão para fazer chamadas ao Inference Providers.

Cliente OpenAI com um token do Hugging Face

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://router.huggingface.co/v1",
    api_key=os.environ["HF_TOKEN"],
)

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4.1-Flash:fastest",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
  • Adicione :fastest ao ID do modelo para escolher o provedor com maior throughput.
  • Adicione :cheapest para escolher o provedor com o menor preço.
  • Adicione o nome de um provedor, por exemplo :novita, para escolher um provedor específico.
  • O endpoint compatível com OpenAI serve somente para chat. Use as bibliotecas cliente do Hugging Face para imagens, embeddings e fala.

Para que serve o Inference Providers

  • Testar muitos modelos abertos com um token, antes de escolher um para produção.
  • Modelos raros em outros lugares, por exemplo lançamentos novos de pesos abertos e modelos para tarefas especiais.
  • Modelos de imagem, vídeo e áudio pelas bibliotecas cliente do Hugging Face.
  • Equipes que já pagam PRO ou Team, porque o crédito incluído é usado primeiro.

Você também pode baixar muitos modelos abertos do Hub e rodá-los no seu próprio hardware. Ferramentas como llama.cpp, vLLM e Ollama os servem localmente. A inferência local não custa crédito de API, mas você precisa de uma GPU ou de um computador rápido. O FreeLLMAPI pode adicionar um servidor local compatível com OpenAI como provedor personalizado, junto com as camadas gratuitas na nuvem.

O Inference Providers não é uma API gratuita para uso diário. Sem crédito mensal, uma conta gratuita paga cada requisição após a compra. O crédito PRO de $2.00 também é pequeno para um agente ou um aplicativo de chat.

Opções gratuitas para modelos abertos

Muitos modelos abertos no Hugging Face também têm camadas gratuitas recorrentes em outros provedores. A tabela mostra os modelos gratuitos mais fortes do catálogo de hoje.

Modelos gratuitos mais fortes do catálogo hoje
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3APINex, UnoRouter1M5 req/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SimNão
Qwen3.8 MaxACLIDE-€20/month shared internal usage credits · no cardSimNão
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 a mais1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashAPINex, Google AI Studio1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
SimSim
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub, Inferbase1M$0.25/week shared recurring creditSimSim
Deepseek V4.1 FlashAPINex1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NãoNão
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
Agnes 3.0 FlashAgnes AI-Promo $0/tokenNãoNão

Mostrando 12 de 354 modelos gratuitos correspondentes. Ver todos os modelos.

Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.

O FreeLLMAPI tem um adaptador para o Hugging Face. O catálogo gratuito de hoje não tem linhas do Hugging Face, porque contas gratuitas não têm crédito recorrente. Para usar modelos abertos gratuitos com uma chave, adicione chaves dos provedores da tabela. O roteador passa para o próximo provedor quando um deles devolve um erro de limite.

Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

Perguntas frequentes

A API de inferência do Hugging Face é gratuita?

Não para contas gratuitas. A página de preços atual não lista crédito mensal para usuários gratuitos. Eles precisam comprar créditos ou assinar o PRO, que inclui $2.00 de crédito de computação por mês.

Usuários gratuitos do Hugging Face ainda recebem $0.10 por mês?

A página oficial de preços não mostra isso hoje. Ela não lista crédito mensal para usuários gratuitos. Páginas antigas e algumas cópias da documentação ainda mostram o valor de $0.10.

Por que o Hugging Face devolve o erro 402 Payment Required?

A sua conta ou a organização cobrada não tem mais crédito. Compre créditos, assine o PRO ou espere o próximo crédito mensal do PRO.

O roteador do Hugging Face é compatível com OpenAI?

Sim, para chat completions. Defina a URL base como https://router.huggingface.co/v1 e use um token do Hugging Face como chave de API.

Qual é uma alternativa gratuita à inferência do Hugging Face?

Use provedores com camadas gratuitas recorrentes para modelos abertos, como Groq, NVIDIA NIM, Cloudflare Workers AI ou OVH AI Endpoints. O FreeLLMAPI os reúne atrás de uma chave.

Guias relacionados

Fontes

Todos os guias · Ver todos os modelos gratuitos