Visió general
L'ús de l'API està subjecte a límits de peticions. Aquests límits restringeixen les peticions, els segments o altres usos durant un període determinat.
Una resposta 429 pot indicar un límit de peticions temporal, un saldo prepagat esgotat o un límit de despesa o d'ús. Comproveu els detalls de l'error abans de tornar-ho a provar o canviar la configuració de facturació.
Identifiqueu la causa
Llegiu el missatge d'error i error.code, si es proporciona. Els errors de facturació poden continuar utilitzant el valor més general insufficient_quota a error.type.
| Error o codi | Què significa | Què cal fer |
| S'ha assolit el límit de peticions o de segments | Les peticions superen un límit de peticions aplicable. | Reguleu el ritme de les peticions i seguiu les indicacions de reintent següents. |
| credit_balance_exhausted | A l'organització no li queden crèdits prepagats. | Afegiu crèdits a la configuració de facturació de l'API. |
| organization_usage_limit_exceeded | L'organització ha assolit el límit d'ús assignat per OpenAI. | Sol·liciteu un límit d'ús aprovat més alt. |
| organization_spend_limit_exceeded | L'organització ha assolit el límit de despesa establert. | Augmenteu o suprimiu el límit, o espereu que es restableixi mensualment. |
| project_spend_limit_exceeded | El projecte ha assolit el límit de despesa establert. | Augmenteu o suprimiu el límit del projecte, o espereu que es restableixi mensualment. |
Reintentar un error de facturació, despesa o quota no restableix l'accés. Resoleu primer el problema de saldo o de límit indicat. Els canvis als límits de despesa establerts 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 teniu accés, demaneu-ho a la persona que gestiona aquesta configuració.
Per comprar crèdits prepagats, consulteu: Configuració i gestió de la facturació prepagada de l'API.
Per conèixer els diferents controls de despesa, consulteu la guia sobre els límits de despesa de l'API.
Comproveu els límits de peticions aplicables
Aneu a la pàgina Límits de l'organització per consultar-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 assignacions per a usuaris individuals. Els límits també varien segons el model, i algunes famílies de models comparteixen un límit.
Comproveu quin límit identifica l'error. Per exemple, les peticions per minut i els segments per minut tenen límits diferents. Podeu assolir-ne un sense superar l'altre.
Confirmeu l'organització que utilitza la petició
Si pertanyeu a diverses organitzacions, confirmeu que les peticions utilitzen l'organització i el projecte previstos.
Si la clau de l'API utilitza una organització predeterminada, comproveu la configuració de l'organització predeterminada. Les organitzacions poden tenir diferents modalitats de facturació i nivells d'ús.
Reduïu els errors temporals de límit de peticions
Reguleu el ritme de les peticions i eviteu les ràfegues
Distribuïu les peticions al llarg del temps en lloc d'enviar-ne moltes alhora.
Els límits de peticions es poden aplicar en períodes més curts que l'interval mostrat. Per exemple, un límit de 60 peticions per minut també es pot aplicar en períodes d'1 segon. Per tant, una ràfega breu pot provocar un error encara que l'ús mitjà sembli inferior al límit per minut.
Les indicacions llargues i uns marges de segments de sortida innecessàriament amplis també poden contribuir als errors de límit de segments.
Torneu-ho a provar després d'una espera
Per als errors temporals de límit de peticions:
Comproveu si la resposta inclou una capçalera Retry-After.
Si la capçalera conté un temps d'espera vàlid, espereu com a mínim aquest temps abans de tornar-ho a provar.
Si la capçalera no hi és o no és vàlida, feu servir un ajornament exponencial amb variació aleatòria: augmenteu l'espera després de cada intent fallit i afegiu-hi un petit retard aleatori.
Limiteu tant el nombre de reintents com el temps total que hi dediqueu.
Els SDK oficials d'OpenAI ja reintenten els errors de límit de peticions admesos i respecten Retry-After quan hi és. Tingueu 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 prolongar el problema.
Per obtenir instruccions i exemples d'implementació, consulteu la guia sobre els límits de peticions de l'API. Reviseu qualsevol biblioteca de reintents de tercers abans d'utilitzar-la a l'aplicació.
Reviseu la mida de la indicació i de la sortida
Elimineu de les indicacions les instruccions innecessàries, el context repetit i els exemples. Proveu la indicació revisada per confirmar que encara produeix el resultat que necessiteu.
Utilitzeu el paràmetre de segments de sortida compatible amb el punt final i el model:
Chat Completions utilitza max_completion_tokens.
Responses utilitza max_output_tokens.
Eviteu establir un marge molt superior al que necessita la petició. Aquests paràmetres inclouen tant els segments de raonament com la sortida visible; per tant, tingueu en compte tots dos quan utilitzeu un model de raonament.
Reviseu el nivell d'ús
Si els errors continuen després de reduir les ràfegues i revisar l'ús de segments, consulteu a la pàgina Límits les opcions disponibles per augmentar els límits.
A mesura que augmenta la despesa de l'API, OpenAI pot promoure automàticament una organització a un nivell d'ús superior. Normalment, això augmenta els límits de peticions de la majoria de models.
El límit mensual d'ús aprovat és independent dels límits de peticions i de segments. Augmentar-ne un no s'ha de considerar una confirmació que l'altre hagi canviat.
Si el problema continua
Abans de derivar el problema
Tingueu a mà el missatge d'error exacte, els codis d'error, els identificadors de petició rellevants, l'hora de l'error amb la zona horària i el límit corresponent que es mostra al compte. Anoteu els passos que ja heu provat.
Contacteu amb el servei d'assistència d'OpenAI
Contacteu amb el servei d'assistència d'OpenAI a través del Centre d'ajuda si no podeu resoldre el problema després de comprovar el límit indicat. No inclogueu claus de l'API ni altres secrets d'autenticació.