Questo è il 429 che il backoff non può risolvere. insufficient_quota significa che il tuo account non ha credito spendibile — la richiesta è stata rifiutata prima dell’esecuzione di qualsiasi modello e continuerà a essere rifiutata finché non cambia la fatturazione. Ecco come confermare lo stato di fatturazione e risolverlo in pochi minuti.
L’errore
{
"error": {
"message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}Cause e soluzioni in breve
| Causa | Soluzione |
|---|---|
| Il saldo dei crediti prepagati è $0 | L’API è prepagata: acquista crediti (oppure abilita la ricarica automatica) in Settings → Billing. Una carta salvata da sola non aggiunge nulla finché non acquisti crediti. |
| I crediti della prova gratuita sono scaduti o esauriti | I crediti della prova scadono (in genere dopo 3 mesi) anche se non utilizzati. La soluzione è la stessa: aggiungi un metodo di pagamento e acquista crediti. |
| È stato raggiunto il limite di budget mensile | Un budget impostato da te in Limits blocca le richieste per il resto del mese una volta raggiunto. Aumentalo oppure aspetta il passaggio al mese successivo. |
| La chiave appartiene a un progetto o a un’organizzazione senza budget | Le chiavi sk-proj- utilizzano il budget del proprio progetto; un progetto può avere un limite proprio, più basso di quello dell’organizzazione. Controlla il progetto della chiave nella dashboard, non solo il totale dell’organizzazione. |
Conferma che si tratta di quota, non di limitazione della frequenza
Leggi error.type. rate_limit_exceeded si risolve da solo entro un minuto e richiede un backoff; insufficient_quota non si risolve da solo e ritentarlo è solo rumore. Se non sei sicuro, un tentativo dopo 60 secondi chiarisce la situazione: se ricevi ancora 429 con lo stesso messaggio, si tratta della fatturazione.
Controlla il saldo dei crediti da cui la chiave attinge effettivamente
In platform.openai.com → Settings → Billing, controlla il saldo dei crediti. Zero o negativo: acquista crediti. Poi controlla Settings → Limits per un eventuale limite di budget mensile e, per le chiavi sk-proj-, i limiti di utilizzo del progetto proprietario. Tutti e tre possono produrre indipendentemente questo errore.
Interrompi la ricorrenza, non solo l'incidente
Attiva la ricarica automatica con una soglia ragionevole, così un fine settimana intenso non mette fuori uso la produzione, e imposta l'avviso di budget (non solo il limite rigido) per sapere che ti stai avvicinando ai limiti prima che le richieste inizino a fallire.
Se chiami tramite Kunavo
Kunavo utilizza lo stesso modello prepagato, quindi il confronto corretto riguarda l'ampiezza d'impatto del portafoglio, non il meccanismo: un unico saldo Kunavo copre insieme GPT e Claude, con prezzi per token, e le richieste non riuscite non vengono mai addebitate. Quando il portafoglio Kunavo si esaurisce ricevi un 402 con il codice insufficient_quota (deliberatamente lo stesso codice, così la gestione degli errori degli OpenAI SDK resta compatibile): la ricarica lo risolve istantaneamente, senza limiti mensili da sbloccare. Stai definendo il budget per la soluzione? Le tariffe GPT attuali per token, con l'elenco ufficiale di OpenAI accanto al nostro, sono disponibili nell' elenco dei prezzi dell'API GPT.
Domande frequenti
Ho aggiunto una carta di credito: perché continuo a ricevere insufficient_quota?
Perché l'API utilizza crediti prepagati, non direttamente la carta. Aggiungere una carta abilita solo gli acquisti; devi comunque acquistare crediti o attivare la ricarica automatica. L'errore scompare entro uno o due minuti da quando il saldo torna positivo.
insufficient_quota si risolve mai da solo?
Solo in un caso: un limite di budget mensile, che si reimposta al cambio del mese. I casi di saldo nullo e prova scaduta persistono finché non acquisti crediti. In ogni caso, i cicli di ritentativo non aiutano: la richiesta viene rifiutata prima dell'esecuzione di qualsiasi modello.
Le richieste 429 non riuscite hanno un costo?
No: OpenAI le rifiuta prima dell'inferenza e anche su Kunavo le richieste non riuscite non vengono mai addebitate. Il costo è il tempo di inattività, per cui la ricarica automatica insieme a un avviso di budget è migliore del solo limite rigido.
Guide correlate
- Limiti di frequenza dell'API OpenAI — quale limite raggiungi, come leggerlo e il retry che lo risolve
- Prezzi API OpenAI GPT 2026 — costi di GPT-6, GPT-5.6 e GPT-5.5, esempi e accesso più economico
Ulteriori dettagli sul significato degli errori sono disponibili in riferimento agli errori; ottenere una chiave richiede un minuto tramite registrazione e la guida all’autenticazione.