Ülevaade
API kasutusele kehtivad kiiruse piirangud. Need piiravad kindla ajavahemiku jooksul päringute, tokenite või muu kasutuse hulka.
Vastus 429 võib viidata ajutisele kiiruse piirangule, ettemakstud saldo lõppemisele või kulu- või kasutuspiirangule. Enne uuesti proovimist või arveldusseadete muutmist kontrollige tõrke üksikasju.
Tuvastage põhjus
Lugege tõrketeadet ja olemasolu korral väärtust error.code. Arveldusega seotud tõrgete laiem väärtus error.type võib endiselt olla insufficient_quota.
| Tõrge või kood | Mida see tähendab | Mida teha |
| Päringute või tokenite kiiruse piirang on saavutatud | Päringud ületavad kehtiva kiiruse piirangu. | Hajutage päringuid ja järgige allolevaid korduskatsete juhiseid. |
| credit_balance_exhausted | Organisatsioonil pole ettemakstud krediite alles. | Lisage API arveldusseadetes krediite. |
| organization_usage_limit_exceeded | Organisatsioon saavutas OpenAI määratud kasutuspiirangu. | Taotlege suurema kasutuspiirangu kinnitamist. |
| organization_spend_limit_exceeded | Organisatsioon saavutas jõustatud kulupiirangu. | Suurendage või eemaldage piirang või oodake selle igakuist lähtestamist. |
| project_spend_limit_exceeded | Projekt saavutas jõustatud kulupiirangu. | Suurendage või eemaldage projekti piirang või oodake selle igakuist lähtestamist. |
Arveldus-, kulu- või kvooditõrke korral uuesti proovimine ei taasta juurdepääsu. Lahendage esmalt teatatud saldo või piirangu probleem. Jõustatud kulupiirangute muudatuste rakendumine võib võtta aega.
Kulupiirangu muutmiseks on vaja õigust hallata asjaomase organisatsiooni või projekti seadeid. Kui teil pole juurdepääsu, pöörduge nende seadete haldaja poole.
Ettemakstud krediitide ostmise kohta vt API ettemakstud arvelduse seadistamine ja haldamine.
Erinevate kulukontrollide kohta vt API kulupiirangute juhendit.
Kontrollige kehtivaid kiiruse piiranguid
Vaadake organisatsiooni praegust kasutustaset ja piiranguid lehel Piirangud.
Kiiruse piirangud võivad kehtida organisatsiooni ja projekti tasandil. Need ei ole üksikkasutajate kasutusmahud. Piirangud erinevad ka mudelite lõikes ning mõnel mudeliperel on ühine piirang.
Kontrollige, millisele piirangule tõrge viitab. Näiteks päringute arv minutis ja tokenite arv minutis on eraldi piirangud. Ühe piirangu võib saavutada, jäädes teisest allapoole.
Kontrollige, millist organisatsiooni teie päring kasutab
Kui kuulute mitmesse organisatsiooni, veenduge, et päringud kasutaksid soovitud organisatsiooni ja projekti.
Kui teie API-võti kasutab vaikeorganisatsiooni, kontrollige vaikeorganisatsiooni seadet. Organisatsioonidel võivad olla erinevad arvelduskorraldused ja kasutustasemed.
Vähendage ajutisi kiiruse piirangu tõrkeid
Hajutage päringuid ja vältige puhanguid
Jaotage päringud aja peale, mitte ärge saatke suurt hulka korraga.
Kiiruse piiranguid võidakse jõustada kuvatud ajavahemikust lühemate perioodide kaupa. Näiteks võidakse piirangut 60 päringut minutis jõustada ka ühesekundiliste perioodide kaupa. Seetõttu võib lühike päringupuhang põhjustada tõrke isegi siis, kui keskmine kasutus näib jäävat minutipiirangust allapoole.
Tokenite kiiruse tõrkeid võivad põhjustada ka pikad viibad ja tarbetult suured väljundtokenite ülempiirid.
Proovige viivitusega uuesti
Ajutiste kiiruse piirangu tõrgete korral:
Kontrollige vastuse päist Retry-After.
Kui päises on kehtiv viivitus, oodake enne uuesti proovimist vähemalt nii kaua.
Kui päis puudub või ei kehti, kasutage juhusliku nihkega eksponentsiaalset tagasivõttu: pikendage iga ebaõnnestunud katse järel viivitust ja lisage lühike juhuslik viivitus.
Piirake nii korduskatsete arvu kui ka neile kuluvat koguaega.
OpenAI ametlikud SDK-d proovivad sobivate kiiruse piirangu tõrgete korral juba automaatselt uuesti ja järgivad päist Retry-After, kui see on olemas. Arvestage nende korduskatsetega enne uue kordustsükli lisamist.
Ebaõnnestunud päringud lähevad minutipõhiste piirangute arvestusse. Sama päringu pidev uuesti saatmine võib probleemi pikendada.
Rakendusjuhised ja näited leiate API kiiruse piirangute juhendist. Enne kolmanda osapoole korduskatsete teegi kasutamist oma rakenduses vaadake see üle.
Vaadake üle viiba ja väljundi maht
Eemaldage viipadest tarbetud juhised, korduv kontekst ja näited. Katsetage muudetud viipa, veendumaks, et see annab endiselt vajaliku tulemuse.
Kasutage oma lõpp-punkti ja mudeli toetatud väljundtokenite parameetrit:
Chat Completions kasutab parameetrit max_completion_tokens.
Responses kasutab parameetrit max_output_tokens.
Ärge määrake päringu vajadusest palju suuremat ülempiiri. Need parameetrid hõlmavad nii arutlustokeneid kui ka nähtavat väljundit, seega arvestage arutlusmudeli kasutamisel mõlemaga.
Vaadake oma kasutustase üle
Kui tõrked jätkuvad pärast päringupuhangute vähendamist ja tokenikasutuse ülevaatamist, vaadake piirangute suurendamise võimalusi lehelt Piirangud.
API-le tehtavate kulutuste suurenedes võib OpenAI organisatsiooni automaatselt kõrgemale kasutustasemele viia. Tavaliselt suurendab see enamiku mudelite kiiruse piiranguid.
Kinnitatud igakuine kasutuspiirang on päringute ja tokenite kiiruse piirangutest eraldi. Ühe suurendamist ei tohiks pidada kinnituseks, et ka teine on muutunud.
Kui probleem püsib
Enne probleemi eskaleerimist
Hoidke käepärast täpne tõrketeade, võimalik tõrkekood, asjakohased päringu-ID-d, tõrke aeg koos ajavööndiga ja kontol kuvatav asjakohane piirang. Pange kirja juba proovitud toimingud.
Võtke ühendust OpenAI kasutajatoega
Kui te ei suuda pärast teatatud piirangu kontrollimist probleemi lahendada, võtke Abikeskuse kaudu ühendust OpenAI kasutajatoega. Ärge lisage API-võtmeid ega muid autentimissaladusi.