Panoramica
L'utilizzo dell'API è soggetto a limiti di richieste. Questi limiti restringono il numero di richieste, di token o altre forme di utilizzo in un determinato periodo.
Una risposta 429 può indicare un limite di richieste temporaneo, l'esaurimento del saldo prepagato oppure un limite di spesa o di utilizzo. Controlla i dettagli dell'errore prima di riprovare o modificare le impostazioni di fatturazione.
Individua la causa
Leggi il messaggio di errore e il valore di error.code, se presente. Anche gli errori relativi alla fatturazione possono usare il valore più generico insufficient_quota per error.type.
| Errore o codice | Significato | Cosa fare |
| Raggiunto il limite di richieste o di token | Le richieste superano uno dei limiti di richieste applicabili. | Distribuisci le richieste nel tempo e segui le indicazioni sui nuovi tentativi riportate di seguito. |
| credit_balance_exhausted | L'organizzazione ha esaurito i crediti prepagati. | Aggiungi crediti nelle impostazioni di fatturazione dell'API. |
| organization_usage_limit_exceeded | L'organizzazione ha raggiunto il limite di utilizzo assegnato da OpenAI. | Richiedi l'approvazione di un limite di utilizzo più alto. |
| organization_spend_limit_exceeded | L'organizzazione ha raggiunto il limite di spesa vincolante. | Aumenta o rimuovi il limite, oppure attendi il ripristino mensile. |
| project_spend_limit_exceeded | Il progetto ha raggiunto il limite di spesa vincolante. | Aumenta o rimuovi il limite del progetto, oppure attendi il ripristino mensile. |
Riprovare dopo un errore di fatturazione, spesa o quota non ripristina l'accesso. Risolvi prima il problema relativo al saldo o al limite segnalato. Le modifiche ai limiti di spesa vincolanti possono richiedere tempo prima di entrare in vigore.
Per modificare un limite di spesa occorre l'autorizzazione a gestire le impostazioni dell'organizzazione o del progetto interessato. Se non hai accesso, rivolgiti alla persona che gestisce queste impostazioni.
Per l'acquisto di crediti prepagati, consulta: Configurazione e gestione della fatturazione prepagata dell'API.
Per i diversi strumenti di controllo della spesa, consulta la guida ai limiti di spesa dell'API.
Controlla i limiti di richieste applicabili
Vai alla pagina Limiti della tua organizzazione per verificarne il livello di utilizzo e i limiti attuali.
I limiti di richieste possono essere applicati a livello di organizzazione e di progetto. Non sono quote assegnate ai singoli utenti. I limiti variano anche in base al modello e alcune famiglie di modelli condividono lo stesso limite.
Controlla quale limite viene indicato nell'errore. Ad esempio, le richieste al minuto e i token al minuto sono limiti distinti. Puoi raggiungerne uno rimanendo al di sotto dell'altro.
Controlla i limiti dell'API per la generazione di immagini
I limiti di richieste dell'API per la generazione di immagini dipendono dal modello e dal tuo livello di utilizzo. Seleziona il tuo modello nella pagina dei modelli per visualizzarne i limiti.
Per le istruzioni di configurazione, consulta la guida per sviluppatori alla generazione di immagini. Per saperne di più sui livelli di utilizzo, consulta la guida ai limiti di richieste dell'API.
Verifica l'organizzazione usata dalla richiesta
Se fai parte di più organizzazioni, verifica che le richieste usino l'organizzazione e il progetto previsti.
Se la tua chiave API usa un'organizzazione predefinita, controlla l'impostazione dell'organizzazione predefinita. Organizzazioni diverse possono avere modalità di fatturazione e livelli di utilizzo differenti.
Riduci gli errori temporanei dovuti ai limiti di richieste
Distribuisci le richieste nel tempo ed evita i picchi
Distribuisci le richieste nel tempo anziché inviarne molte tutte insieme.
I limiti di richieste possono essere applicati su periodi più brevi dell'intervallo indicato. Ad esempio, un limite di 60 richieste al minuto può essere applicato anche su periodi di 1 secondo. Un breve picco può quindi causare un errore anche se l'utilizzo medio sembra inferiore al limite al minuto.
Anche prompt lunghi e limiti di token di output inutilmente elevati possono contribuire agli errori dovuti ai limiti di token per intervallo di tempo.
Attendi prima di riprovare
Per gli errori temporanei dovuti ai limiti di richieste:
Controlla se la risposta contiene l'header Retry-After.
Se l'header contiene un tempo di attesa valido, attendi almeno per quel tempo prima di riprovare.
Se l'header è assente o non valido, usa il backoff esponenziale con jitter: aumenta il tempo di attesa dopo ogni tentativo non riuscito e aggiungi un breve ritardo casuale.
Limita sia il numero di nuovi tentativi sia il tempo totale dedicato a riprovare.
Gli SDK ufficiali di OpenAI riprovano già le richieste in caso di errori relativi ai limiti di richieste che lo consentono e rispettano Retry-After, quando presente. Tieni conto di questi tentativi prima di aggiungere un altro ciclo di tentativi.
Anche le richieste non riuscite vengono conteggiate ai fini dei limiti al minuto. Inviare di continuo la stessa richiesta può prolungare il problema.
Per indicazioni sull'implementazione ed esempi, consulta la guida ai limiti di richieste dell'API. Valuta qualsiasi libreria di terze parti per la gestione dei nuovi tentativi prima di usarla nella tua applicazione.
Verifica la lunghezza dei prompt e dell'output
Rimuovi dai prompt le istruzioni superflue, le informazioni di contesto ripetute e gli esempi non necessari. Prova il prompt modificato per verificare che produca ancora il risultato di cui hai bisogno.
Usa il parametro per i token di output supportato dal tuo endpoint e dal tuo modello:
Chat Completions usa max_completion_tokens.
Responses usa max_output_tokens.
Evita di impostare un limite molto più alto di quanto serva alla richiesta. Questi parametri includono sia i token di ragionamento sia l'output visibile, quindi tieni conto di entrambi quando usi un modello di ragionamento.
Verifica il tuo livello di utilizzo
Se gli errori persistono dopo aver ridotto i picchi e verificato l'utilizzo dei token, consulta la pagina Limiti per vedere le opzioni disponibili per aumentare i tuoi limiti.
Il livello di utilizzo a pagamento della tua organizzazione aumenta automaticamente quando gli acquisti totali di crediti raggiungono le soglie Build, Launch e Grow. I livelli superiori offrono in genere limiti di richieste più alti. Consulta la guida ai limiti di richieste dell'API per i requisiti dei vari livelli.
Il tuo limite di utilizzo mensile approvato è distinto dai limiti di richieste e di token per intervallo di tempo. L'aumento di un limite non va considerato una conferma della modifica degli altri.
Se il problema persiste
Prima di contattare l'assistenza
Tieni a portata di mano il messaggio di errore esatto, gli eventuali codici di errore, gli ID delle richieste interessate, l'ora dell'errore con il tuo fuso orario e il limite pertinente indicato nel tuo account. Prendi nota dei passaggi che hai già provato.
Contatta l'assistenza OpenAI
Contatta l'assistenza OpenAI tramite il Centro assistenza se non riesci a risolvere il problema dopo aver controllato il limite segnalato. Non includere chiavi API o altri dati segreti di autenticazione.