Home / Guide / Limite gratuito dell'API Hugging Face Inference

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.

Crediti mensili di Inference Providers, dalla pagina dei prezzi di Hugging Face (verificato il 20 novembre 2026)
Tipo di accountCredito mensilePay as you go
Utente gratuitoNessunoSì, serve l'acquisto di crediti
Utente PRO$2.00Sì
Organizzazione Team o Enterprise$2.00 per posto, condivisi nell'organizzazioneSì
Cifra precedente: molte pagine dicono ancora che gli utenti gratuiti ricevono $0.10 al mese. Quella cifra non compare oggi nella pagina ufficiale dei prezzi. Tracker di terze parti hanno registrato il cambiamento a ottobre 2026. Le vecchie pagine della documentazione di Hugging Face possono ancora mostrare il valore precedente.

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.

CausaSoluzione
Account gratuito senza credito acquistatoAcquista crediti nella pagina di fatturazione, oppure passa a PRO
Il credito PRO di questo mese è esauritoAttendi il mese successivo, oppure acquista altri crediti
La richiesta fattura un'organizzazione senza creditoRimuovi 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

  1. Accedi a Hugging Face e apri le impostazioni dei token.
  2. Crea un token fine-grained.
  3. Dai al token il permesso «Make calls to Inference Providers».
  4. Salva il token nella variabile d'ambiente HF_TOKEN.
  5. 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 :fastest all'ID del modello per scegliere il provider con la maggiore velocità di elaborazione.
  • Aggiungi :cheapest per 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.

Modelli gratuiti più forti nel catalogo di oggi
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3APINex, UnoRouter1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SìNo
Qwen3.8 MaxACLIDE-€20/month shared internal usage credits · no cardSìNo
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 altri1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashAPINex, Google AI Studio1M5 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 NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub, Inferbase1M$0.25/week shared recurring creditSìSì
Deepseek V4.1 FlashAPINex1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NoNo
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
Agnes 3.0 FlashAgnes AI-Promo $0/tokenNoNo

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.

Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

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

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti