Visió general
L'ús de l'API està subjecte a límits de peticions. Aquests límits restringeixen les peticions, els segments o altres tipus d'ús durant un període determinat.
Una resposta 429 pot indicar un límit temporal de peticions, un saldo de prepagament esgotat o un límit de despesa o d'ús. Comprova els detalls de l'error abans de tornar-ho a provar o de canviar la configuració de facturació.
Identifica la causa
Llegeix el missatge d'error i error.code, si s'inclou. Els errors relacionats amb la facturació també poden fer servir el valor més general insufficient_quota a error.type.
| Error o codi | Què significa | Què cal fer |
| S'ha arribat al límit de peticions o de segments | Les peticions superen un dels límits de peticions aplicables. | Espaia les peticions i segueix les indicacions sobre reintents que trobaràs a continuació. |
| credit_balance_exhausted | A l'organització no li queden crèdits de prepagament. | Afegeix crèdits a la configuració de facturació de l'API. |
| organization_usage_limit_exceeded | L'organització ha arribat al límit d'ús assignat per OpenAI. | Sol·licita que s'aprovi un límit d'ús més alt. |
| organization_spend_limit_exceeded | L'organització ha arribat al seu límit de despesa d'aplicació obligatòria. | Augmenta o elimina el límit, o espera que es restableixi el còmput mensual. |
| project_spend_limit_exceeded | El projecte ha arribat al seu límit de despesa d'aplicació obligatòria. | Augmenta o elimina el límit del projecte, o espera que es restableixi el còmput mensual. |
Tornar-ho a provar després d'un error de facturació, despesa o quota no restableix l'accés. Resol primer el problema amb el saldo o el límit indicat. Els canvis en els límits de despesa d'aplicació obligatòria poden trigar a aplicar-se.
Per canviar un límit de despesa, cal tenir permís per gestionar la configuració de l'organització o del projecte corresponent. Si no hi tens accés, demana-ho a la persona que gestiona aquesta configuració.
Per comprar crèdits de prepagament, consulta: Configurar i gestionar la facturació de prepagament de l'API.
Per conèixer els diferents controls de despesa, consulta la guia de límits de despesa de l'API.
Comprova els límits de peticions aplicables
Ves a la pàgina de límits de la teva organització per revisar-ne el nivell d'ús i els límits actuals.
Els límits de peticions es poden aplicar tant a l'organització com al projecte. No són quotes individuals per usuari. Els límits també varien segons el model, i algunes famílies de models comparteixen un límit.
Comprova quin límit indica l'error. Per exemple, les peticions per minut i els segments per minut tenen límits independents. Pots arribar a un límit i continuar per sota de l'altre.
Comprova els límits de l'API de generació d'imatges
Els límits de peticions de l'API de generació d'imatges depenen del model i del teu nivell d'ús. Selecciona el teu model a la pàgina de models per veure'n els límits.
Per obtenir instruccions de configuració, consulta la guia de generació d'imatges per a desenvolupadors. Per obtenir més informació sobre els nivells d'ús, consulta la guia de límits de peticions de l'API.
Confirma l'organització que fa servir la teva petició
Si pertanys a diverses organitzacions, confirma que les teves peticions fan servir l'organització i el projecte previstos.
Si la teva clau d'API fa servir una organització predeterminada, comprova la configuració de l'organització predeterminada. Cada organització pot tenir condicions de facturació i nivells d'ús diferents.
Redueix els errors temporals per límits de peticions
Espaia les peticions i evita les ràfegues
Distribueix les peticions al llarg del temps en lloc d'enviar-ne moltes alhora.
Els límits de peticions es poden aplicar a períodes més curts que l'interval mostrat. Per exemple, un límit de 60 peticions per minut també es pot aplicar a períodes d'1 segon. Per tant, una ràfega breu pot provocar un error encara que l'ús mitjà sembli estar per sota del límit per minut.
Les indicacions llargues i els màxims de segments de sortida innecessàriament alts també poden contribuir als errors per límits de segments per unitat de temps.
Espera abans de tornar-ho a provar
En cas d'errors temporals per límits de peticions:
Comprova si la resposta inclou una capçalera Retry-After.
Si la capçalera conté un temps d'espera vàlid, espera almenys aquest temps abans de tornar-ho a provar.
Si la capçalera no hi és o no és vàlida, aplica una espera exponencial amb variació aleatòria: augmenta el temps d'espera després de cada intent fallit i afegeix-hi una petita espera aleatòria.
Limita tant el nombre de reintents com el temps total que hi dediques.
Els SDK oficials d'OpenAI ja reintenten les peticions amb errors per límits de peticions que ho permeten i respecten Retry-After quan hi és. Tingues en compte aquests reintents abans d'afegir un altre bucle de reintents.
Les peticions fallides compten per als límits per minut. Reenviar contínuament la mateixa petició pot allargar el problema.
Per obtenir orientacions i exemples d'implementació, consulta la guia de límits de peticions de l'API. Revisa qualsevol biblioteca de reintents de tercers abans de fer-la servir a la teva aplicació.
Revisa la mida de les indicacions i de la sortida
Elimina de les indicacions les instruccions innecessàries, el context repetit i els exemples. Prova la indicació revisada per confirmar que continua produint el resultat que necessites.
Fes servir el paràmetre de segments de sortida compatible amb el teu punt final i model:
Chat Completions fa servir max_completion_tokens.
Responses fa servir max_output_tokens.
Evita establir un màxim molt superior al que necessita la petició. Aquests paràmetres inclouen tant els segments de raonament com la sortida visible; per tant, preveu marge per a tots dos quan facis servir un model de raonament.
Revisa el teu nivell d'ús
Si els errors persisteixen després de reduir les ràfegues i revisar l'ús de segments, consulta la pàgina de límits per veure les opcions disponibles per augmentar-los.
El nivell d'ús de pagament de la teva organització puja automàticament a mesura que el total de compres de crèdits arriba als llindars de Build, Launch i Grow. Els nivells superiors solen oferir límits de peticions més alts. Consulta els requisits de cada nivell a la guia de límits de peticions de l'API.
El teu límit d'ús mensual aprovat és independent dels límits de peticions i de segments per unitat de temps. No donis per fet que augmentar un tipus de límit implica que l'altre també ha canviat.
Si el problema persisteix
Abans de contactar amb el suport
Tingues a mà el missatge d'error exacte, qualsevol codi d'error, els identificadors de les peticions afectades, l'hora de l'error amb el fus horari i el límit corresponent que apareix al teu compte. Anota els passos que ja has provat.
Contacta amb el suport d'OpenAI
Contacta amb el suport d'OpenAI a través del Centre d'ajuda si no pots resoldre el problema després de comprovar el límit indicat. No incloguis claus d'API ni altres dades secretes d'autenticació.