Limite gratuito dell'API Hugging Face Inference
Hugging Face Inference Providers è un'unica API per modelli aperti di molti provider di inferenza. Un tempo includeva un piccolo credito mensile gratuito per ogni account. Oggi la pagina dei prezzi ufficiale non elenca nessun credito mensile per gli utenti gratuiti. Questa guida spiega le regole attuali, l'errore 402 e le opzioni gratuite.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
Il limite gratuito attuale
La pagina dei prezzi di Hugging Face per Inference Providers ha una tabella dei crediti mensili per tipo di account. Gli utenti gratuiti non ricevono crediti mensili. Possono usare Inference Providers solo se acquistano crediti o passano a PRO.
| Tipo di account | Credito mensile | Pay as you go |
|---|---|---|
| Utente gratuito | Nessuno | Sì, serve l'acquisto di crediti |
| Utente PRO | $2.00 | Sì |
| Organizzazione Team o Enterprise | $2.00 per posto, condivisi nell'organizzazione | Sì |
I crediti PRO e Team sono crediti di calcolo generali. Puoi spenderli anche per Inference Endpoints, hardware di Spaces e Jobs. Hugging Face addebita la tariffa del provider senza costi extra.
Perché ottieni l'errore 402
HTTP 402 significa pagamento richiesto. Su Inference Providers, di solito lo ottieni quando il tuo account non ha più credito. Con un account gratuito senza credito acquistato, la prima richiesta a pagamento può restituire 402.
| Causa | Soluzione |
|---|---|
| Account gratuito senza credito acquistato | Acquista crediti nella pagina di fatturazione, oppure passa a PRO |
| Il credito PRO di questo mese è esaurito | Attendi il mese successivo, oppure acquista altri crediti |
| La richiesta fattura un'organizzazione senza credito | Rimuovi l'intestazione X-HF-Bill-To, oppure chiedi all'amministratore dell'organizzazione di aggiungere credito |
Può comparire un errore diverso quando un'organizzazione disattiva un provider. Se richiedi quel provider per nome, la richiesta fallisce. Usa la selezione automatica del provider oppure scegline un altro.
Controlla il tuo utilizzo nella pagina delle impostazioni di Inference Providers. Mostra l'utilizzo del mese passato per modello e per provider.
Come funziona l'API
- Accedi a Hugging Face e apri le impostazioni dei token.
- Crea un token fine-grained.
- Dai al token il permesso «Make calls to Inference Providers».
- Salva il token nella variabile d'ambiente
HF_TOKEN. - Acquista crediti oppure passa a PRO. Senza credito, un account gratuito non può completare richieste a pagamento.
Inference Providers ha un endpoint compatibile con OpenAI per le chat completions su https://router.huggingface.co/v1. Ti autentichi con un token fine-grained di Hugging Face che ha il permesso di chiamare Inference Providers.
Client OpenAI con un token 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)- Aggiungi
:fastestall'ID del modello per scegliere il provider con la maggiore velocità di elaborazione. - Aggiungi
:cheapestper scegliere il provider con il prezzo più basso. - Aggiungi il nome di un provider, per esempio
:novita, per sceglierne uno solo. - L'endpoint compatibile con OpenAI è solo per la chat. Per immagini, embedding e voce, usa le librerie client di Hugging Face.
A cosa serve Inference Providers
- Testare molti modelli aperti con un solo token, prima di sceglierne uno per la produzione.
- Modelli rari altrove, per esempio nuove release open-weight e modelli per compiti speciali.
- Modelli di immagini, video e audio tramite le librerie client di Hugging Face.
- Team che già pagano PRO o Team, perché il credito incluso si applica per primo.
Puoi anche scaricare molti modelli aperti dall'Hub ed eseguirli sul tuo hardware. Strumenti come llama.cpp, vLLM e Ollama li servono in locale. L'inferenza locale non costa credito API, ma ti serve una GPU o un computer veloce. FreeLLMAPI può aggiungere un server locale compatibile con OpenAI come provider personalizzato, accanto ai piani cloud gratuiti.
Inference Providers non è un'API gratuita per l'uso quotidiano. Senza credito mensile, un account gratuito paga ogni richiesta dopo l'acquisto. Anche il credito PRO di $2.00 è piccolo per un agente o un'app di chat.
Opzioni gratuite per i modelli aperti
Molti modelli aperti su Hugging Face hanno anche piani gratuiti ricorrenti presso altri provider. La tabella mostra i modelli gratuiti più forti nel catalogo di oggi.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sì | No |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | Sì | No |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 altri | 1M | 40 richieste/min 40 RPM | Sì | Sì |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sì | Sì |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sì | No |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Deepseek V4.1 Flash | APINex | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | No | No |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 richieste/min 50 richieste/giorno 50 req/day account-wide (1,000 after a $10 purchase) | Sì | Sì |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | No | No |
Mostrati 12 di 354 modelli gratuiti corrispondenti. Vedi tutti i modelli.
Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.
FreeLLMAPI ha un adapter per Hugging Face. Il catalogo gratuito di oggi non ha righe Hugging Face, perché gli account gratuiti non hanno credito ricorrente. Per usare modelli aperti gratuiti con una sola chiave, aggiungi chiavi dei provider nella tabella. Il router passa al provider successivo quando uno restituisce un errore di limite di frequenza.
Domande frequenti
L'API Hugging Face Inference è gratuita?
Non per gli account gratuiti. La pagina dei prezzi attuale non elenca nessun credito mensile per gli utenti gratuiti. Devono acquistare crediti oppure passare a PRO, che include $2.00 di credito di calcolo al mese.
Gli utenti gratuiti di Hugging Face ricevono ancora $0.10 al mese?
La pagina ufficiale dei prezzi oggi non lo mostra. Elenca nessun credito mensile per gli utenti gratuiti. Le pagine più vecchie e alcune copie della documentazione mostrano ancora il valore di $0.10.
Perché Hugging Face restituisce l'errore 402 Payment Required?
Il tuo account, o l'organizzazione a cui viene fatturata la richiesta, non ha più credito. Acquista crediti, passa a PRO oppure attendi il prossimo credito PRO mensile.
Il router di Hugging Face è compatibile con OpenAI?
Sì, per le chat completions. Imposta l'URL base su https://router.huggingface.co/v1 e usa un token Hugging Face come chiave API.
Qual è un'alternativa gratuita a Hugging Face Inference?
Usa provider con piani gratuiti ricorrenti per i modelli aperti, come Groq, NVIDIA NIM, Cloudflare Workers AI o OVH AI Endpoints. FreeLLMAPI li riunisce dietro un'unica chiave.
Guide correlate
- Base URL di API gratuite compatibili con OpenAI
- API LLM gratuita senza carta di credito
- Rate limit delle Free LLM API
- API gratuita OVH AI Endpoints
- API gratuita per embedding
Fonti
- Hugging Face docs: Inference Providers pricing and billing (verificato il 20 November 2026)
- Hugging Face docs: Inference Providers (verificato il 20 November 2026)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (verificato il 20 November 2026)
- FreeLLMAPI docs: Supported platforms (verificato il 20 November 2026)