Prehľad
Na používanie API sa vzťahujú limity požiadaviek. Tieto limity obmedzujú počet požiadaviek, tokenov alebo iné využitie za určené obdobie.
Odpoveď s kódom 429 môže signalizovať dočasné dosiahnutie limitu požiadaviek, vyčerpanie predplateného zostatku alebo dosiahnutie limitu výdavkov či využitia. Pred opätovným pokusom alebo zmenou nastavení fakturácie skontrolujte podrobnosti o chybe.
Zistite príčinu
Prečítajte si chybové hlásenie a hodnotu error.code, ak je uvedená. Aj chyby súvisiace s fakturáciou môžu mať v poli error.type všeobecnejšiu hodnotu insufficient_quota.
| Chyba alebo kód | Čo to znamená | Čo robiť |
| Dosiahnutý limit počtu požiadaviek alebo tokenov za daný čas | Požiadavky prekračujú príslušný limit požiadaviek. | Rozložte požiadavky v čase a riaďte sa nižšie uvedenými pokynmi na opakovanie pokusov. |
| credit_balance_exhausted | Organizácii nezostali žiadne predplatené kredity. | Doplňte kredity v nastaveniach fakturácie API. |
| organization_usage_limit_exceeded | Organizácia dosiahla limit využitia, ktorý jej pridelila spoločnosť OpenAI. | Požiadajte o schválenie vyššieho limitu využitia. |
| organization_spend_limit_exceeded | Organizácia dosiahla svoj pevný limit výdavkov. | Zvýšte alebo odstráňte limit, prípadne počkajte na jeho mesačné obnovenie. |
| project_spend_limit_exceeded | Projekt dosiahol svoj pevný limit výdavkov. | Zvýšte alebo odstráňte limit projektu, prípadne počkajte na jeho mesačné obnovenie. |
Opakovaním pokusu pri chybe súvisiacej s fakturáciou, výdavkami alebo kvótou sa prístup neobnoví. Najprv vyriešte nahlásený problém so zostatkom alebo limitom. Uplatnenie zmien pevných limitov výdavkov môže chvíľu trvať.
Na zmenu limitu výdavkov potrebujete oprávnenie spravovať nastavenia príslušnej organizácie alebo projektu. Ak nemáte prístup, obráťte sa na osobu, ktorá tieto nastavenia spravuje.
Informácie o nákupe predplatených kreditov nájdete v článku Nastavenie a správa predplatenej fakturácie API.
Informácie o rôznych možnostiach riadenia výdavkov nájdete v príručke limitov výdavkov na API.
Skontrolujte príslušné limity požiadaviek
Na stránke Limity svojej organizácie si pozrite jej aktuálnu úroveň využitia a limity.
Limity požiadaviek sa môžu uplatňovať na úrovni organizácie aj projektu. Nejde o kvóty pre jednotlivých používateľov. Limity sa líšia aj podľa modelu a niektoré rodiny modelov majú spoločný limit.
Skontrolujte, na ktorý limit chyba odkazuje. Napríklad počet požiadaviek za minútu a počet tokenov za minútu majú samostatné limity. Jeden z nich môžete dosiahnuť, aj keď ste stále pod druhým.
Skontrolujte limity API na generovanie obrázkov
Limity požiadaviek API na generovanie obrázkov závisia od modelu a vašej úrovne využitia. Na stránke modelov vyberte svoj model a zobrazte si jeho limity.
Pokyny na nastavenie nájdete v príručke generovania obrázkov pre vývojárov. Viac o úrovniach využitia nájdete v príručke limitov požiadaviek API.
Overte, ktorú organizáciu používa vaša požiadavka
Ak ste členom viacerých organizácií, overte, či vaše požiadavky používajú zamýšľanú organizáciu a projekt.
Ak váš kľúč API používa predvolenú organizáciu, skontrolujte nastavenie predvolenej organizácie. Rôzne organizácie môžu mať odlišné fakturačné podmienky a úrovne využitia.
Obmedzte dočasné chyby súvisiace s limitom požiadaviek
Rozložte požiadavky v čase a vyhnite sa nárazovému odosielaniu
Namiesto odosielania veľkého množstva požiadaviek naraz ich rozložte v čase.
Limity požiadaviek sa môžu uplatňovať aj v kratších obdobiach, než je zobrazený interval. Napríklad limit 60 požiadaviek za minútu sa môže uplatňovať aj v jednosekundových intervaloch. Krátke nárazové odoslanie požiadaviek preto môže vyvolať chybu, aj keď sa vaše priemerné využitie zdá byť pod limitom za minútu.
K chybám súvisiacim s limitom počtu tokenov za daný čas môžu prispieť aj dlhé príkazy a zbytočne vysoké povolené počty výstupných tokenov.
Opakujte pokus s odstupom
Pri dočasných chybách súvisiacich s limitom požiadaviek:
Skontrolujte, či odpoveď obsahuje hlavičku Retry-After.
Ak hlavička obsahuje platný čas čakania, pred opätovným pokusom počkajte aspoň tak dlho.
Ak hlavička chýba alebo je neplatná, použite exponenciálne predlžovanie čakania s náhodnou odchýlkou: po každom neúspešnom pokuse predĺžte čas čakania a pridajte krátke náhodné oneskorenie.
Obmedzte počet opakovaných pokusov aj celkový čas strávený ich opakovaním.
Oficiálne súpravy SDK od OpenAI už automaticky opakujú požiadavky pri vhodných chybách súvisiacich s limitom požiadaviek a rešpektujú hlavičku Retry-After, ak je prítomná. Pred pridaním ďalšej slučky opakovaných pokusov zohľadnite tieto automatické pokusy.
Do limitov za minútu sa započítavajú aj neúspešné požiadavky. Neustále opätovné odosielanie rovnakej požiadavky môže predĺžiť trvanie problému.
Pokyny na implementáciu a príklady nájdete v príručke limitov požiadaviek API. Pred použitím knižnice tretej strany na opakovanie pokusov vo svojej aplikácii ju dôkladne preverte.
Skontrolujte dĺžku príkazu a výstupu
Odstráňte z príkazov zbytočné pokyny, opakujúci sa kontext a príklady. Otestujte upravený príkaz a overte, či stále prináša požadovaný výsledok.
Použite parameter pre výstupné tokeny, ktorý podporuje váš koncový bod a model:
Chat Completions používa max_completion_tokens.
Responses používa max_output_tokens.
Nenastavujte oveľa vyšší povolený počet tokenov, než požiadavka potrebuje. Tieto parametre zahŕňajú tokeny uvažovania aj viditeľného výstupu, preto pri použití uvažovacieho modelu počítajte s oboma.
Skontrolujte svoju úroveň využitia
Ak chyby pretrvávajú aj po obmedzení nárazového odosielania a kontrole spotreby tokenov, pozrite si na stránke Limity dostupné možnosti zvýšenia limitov.
Platená úroveň využitia vašej organizácie sa automaticky zvýši, keď celková hodnota nakúpených kreditov dosiahne prahy úrovní Build, Launch a Grow. Vyššie úrovne spravidla poskytujú vyššie limity požiadaviek. Podmienky jednotlivých úrovní nájdete v príručke limitov požiadaviek API.
Váš schválený mesačný limit využitia je nezávislý od limitov počtu požiadaviek a tokenov za daný čas. Zvýšenie jedného limitu neznamená, že sa zmenil aj druhý.
Ak problém pretrváva
Skôr než sa obrátite na podporu
Pripravte si presné znenie chybového hlásenia, prípadný kód chyby, príslušné ID požiadaviek, čas výskytu chyby vrátane časového pásma a príslušný limit zobrazený vo vašom účte. Poznačte si kroky, ktoré ste už vyskúšali.
Kontaktujte podporu OpenAI
Ak sa vám problém nepodarí vyriešiť ani po kontrole nahláseného limitu, kontaktujte podporu OpenAI prostredníctvom Centra pomoci. Neuvádzajte kľúče API ani iné tajné autentifikačné údaje.