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.
| Tipo de conta | Crédito mensal | Pague conforme o uso |
|---|---|---|
| Usuário gratuito | Nenhum | Sim, é preciso comprar crédito |
| Usuário PRO | $2.00 | Sim |
| Organização Team ou Enterprise | $2.00 por assento, compartilhados na organização | Sim |
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.
| Causa | Solução |
|---|---|
| Conta gratuita sem crédito comprado | Compre créditos na página de faturamento, ou assine o PRO |
| O crédito PRO deste mês foi gasto | Espere o próximo mês, ou compre mais créditos |
| A requisição cobra de uma organização sem crédito | Remova 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
- Entre no Hugging Face e abra as configurações de token.
- Crie um token de granularidade fina.
- Dê ao token a permissão "Make calls to Inference Providers".
- Guarde o token na variável de ambiente
HF_TOKEN. - 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
:fastestao ID do modelo para escolher o provedor com maior throughput. - Adicione
:cheapestpara 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.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sim | Não |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | Sim | Não |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 a mais | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sim | Sim |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sim | Não |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Deepseek V4.1 Flash | APINex | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Não | Não |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | Não | Nã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.
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
- URLs base de APIs gratuitas compatíveis com OpenAI
- API gratuita de LLM sem cartão de crédito
- Limites de taxa da API LLM gratuita
- API gratuita da OVH AI Endpoints
- API gratuita de embeddings
Fontes
- Hugging Face docs: Inference Providers pricing and billing (verificado em 20 November 2026)
- Hugging Face docs: Inference Providers (verificado em 20 November 2026)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (verificado em 20 November 2026)
- FreeLLMAPI docs: Supported platforms (verificado em 20 November 2026)