Panoramica
Un errore di fatturazione o di quota dell'API può indicare che hai raggiunto un limite di utilizzo approvato o un limite di spesa configurato oppure che hai esaurito i crediti prepagati. Controlla l'errore prima di modificare le impostazioni.
Identifica l'errore
Controlla error.code nella risposta dell'API. Un errore relativo alla fatturazione può comunque usare il valore più generico insufficient_quota per error.type.
| Codice di errore | Significato | Passaggio successivo |
| organization_usage_limit_exceeded | La tua organizzazione ha raggiunto il limite di utilizzo assegnato da OpenAI. | Verifica il limite approvato e le opzioni disponibili per aumentarlo. |
| organization_spend_limit_exceeded | La tua organizzazione ha raggiunto un limite di spesa rigido configurato. | Verifica i controlli di spesa dell'organizzazione. |
| project_spend_limit_exceeded | Il tuo progetto ha raggiunto un limite di spesa rigido configurato. | Verifica i controlli di spesa del progetto. |
| credit_balance_exhausted | La tua organizzazione ha esaurito i crediti prepagati. | Aggiungi crediti al saldo dell'API. |
Ripetere le richieste che generano questi errori non ripristinerà l'accesso finché non interverrai sui crediti o sui limiti pertinenti. Per maggiori dettagli, consulta la guida ai codici di errore dell'API.
Verifica il limite di utilizzo approvato
Vai alla pagina Limiti dell'organizzazione per controllare il limite di utilizzo mensile attualmente approvato e il livello di utilizzo.
Con l'aumento della spesa per l'API, OpenAI sposta automaticamente la tua organizzazione a livelli di utilizzo superiori. In genere, ciò aumenta i limiti di richieste per la maggior parte dei modelli. Fai riferimento ai limiti indicati per la tua organizzazione, senza presumere che tutti gli account abbiano la stessa disponibilità mensile.
Per i dettagli sui livelli, consulta la guida ai limiti di richieste dell'API.
Controlla i controlli di spesa configurati
Gli avvisi di spesa inviano notifiche senza interrompere il traffico API. I limiti di spesa rigidi possono bloccare le richieste interessate quando la spesa registrata raggiunge l'importo configurato.
Possono essere applicati sia limiti dell'organizzazione sia limiti dei progetti. Un limite dell'organizzazione si applica ai relativi progetti; un limite del progetto si applica al traffico fatturato a quel progetto. Questi controlli sono distinti dal limite di utilizzo approvato da OpenAI.
Se l'errore è stato causato da un limite rigido, chi dispone dell'autorizzazione per gestire le impostazioni pertinenti può aumentarlo o rimuoverlo se la spesa deve continuare. In caso contrario, si reimposta all'inizio del ciclo mensile successivo. Le modifiche e la loro applicazione non sono immediate, quindi la spesa registrata può superare leggermente l'importo configurato.
Per le impostazioni e le istruzioni, consulta la guida ai limiti di spesa dell'API.
Controlla il saldo prepagato
Se hai esaurito i crediti prepagati, vai al portale di fatturazione dell'API e seleziona Acquista crediti o Aggiungi al saldo crediti, a seconda dell'opzione visualizzata, per acquistarne altri. Potrebbero essere necessari alcuni minuti prima che venga visualizzato il saldo aggiornato.
Per istruzioni sulla configurazione e sulla ricarica, consulta: Configurazione della fatturazione prepagata.
Verifica se si tratta di un errore relativo al limite di richieste
I limiti di richieste e token determinano la velocità con cui puoi usare l'API. Sono diversi dai limiti di utilizzo mensili, dai controlli di spesa e dal saldo prepagato.
Per gli errori relativi ai limiti di richieste o token, consulta: Risoluzione degli errori relativi ai limiti di richieste dell'API.
Se il problema persiste
Prima di richiedere assistenza
Tieni a portata di mano il messaggio e il codice di errore, l'ora in cui si è verificato con il relativo fuso orario e gli eventuali ID richiesta pertinenti. Rimuovi le informazioni sensibili dagli screenshot o dal codice che condividi.
Contatta l'assistenza OpenAI
Se le tue esigenze superano i limiti disponibili per l'organizzazione, hai un caso d'uso particolare o l'errore persiste dopo che ne hai risolto la causa, contatta l'assistenza OpenAI tramite il widget della chat nel Centro assistenza.
Per le istruzioni di contatto e le informazioni da includere, consulta: Contattare l'assistenza.