Yfirlit
Notkun API er háð hraðatakmörkunum. Þessi mörk takmarka fjölda beiðna, tóka eða aðra notkun á tilteknu tímabili.
429-svar getur gefið til kynna tímabundna hraðatakmörkun, að fyrirframgreidd inneign sé uppurin eða að útgjalda- eða notkunarmörkum hafi verið náð. Skoðaðu upplýsingar um villuna áður en þú reynir aftur eða breytir greiðslustillingunum.
Finndu orsökina
Lestu villuboðin og error.code, ef það er tilgreint. Greiðslutengdar villur geta samt notað víðara error.type-gildið insufficient_quota.
| Villa eða kóði | Hvað það þýðir | Hvað á að gera |
| Hraðatakmörkun beiðna eða tóka náð | Beiðnirnar fara yfir viðeigandi hraðatakmörkun. | Dreifðu beiðnunum og fylgdu leiðbeiningunum um endurtilraunir hér fyrir neðan. |
| credit_balance_exhausted | Skipulagseiningin á engar fyrirframgreiddar inneignir eftir. | Bættu við inneignum í greiðslustillingum API. |
| organization_usage_limit_exceeded | Skipulagseiningin hefur náð notkunarmörkunum sem OpenAI úthlutaði henni. | Óskaðu eftir samþykktum hærri notkunarmörkum. |
| organization_spend_limit_exceeded | Skipulagseiningin hefur náð þvinguðum útgjaldamörkum sínum. | Hækkaðu eða fjarlægðu mörkin, eða bíddu eftir mánaðarlegri endurstillingu. |
| project_spend_limit_exceeded | Verkefnið hefur náð þvinguðum útgjaldamörkum sínum. | Hækkaðu eða fjarlægðu mörk verkefnisins, eða bíddu eftir mánaðarlegri endurstillingu. |
Endurtilraun vegna villu í greiðslum, útgjöldum eða kvóta endurheimtir ekki aðgang. Lagaðu fyrst inneignina eða mörkin sem villan tilgreinir. Það getur tekið tíma þar til breytingar á þvinguðum útgjaldamörkum taka gildi.
Til að breyta útgjaldamörkum þarf heimild til að stjórna stillingum viðkomandi skipulagseiningar eða verkefnis. Ef þú hefur ekki aðgang skaltu biðja þann sem stjórnar þessum stillingum um aðstoð.
Upplýsingar um kaup á fyrirframgreiddum inneignum: Uppsetning og umsjón fyrirframgreiddra API-greiðslna.
Upplýsingar um mismunandi útgjaldastýringar er að finna í leiðbeiningum um útgjaldamörk API.
Athugaðu viðeigandi hraðatakmarkanir
Farðu á Mörk-síðu skipulagseiningarinnar til að skoða núverandi notkunarstig hennar og mörk.
Hraðatakmarkanir geta gilt fyrir skipulagseiningar og verkefni. Þær eru ekki heimildir fyrir einstaka notendur. Mörkin eru einnig mismunandi eftir líkani og sum líkanafjölskyldur deila mörkum.
Athugaðu hvaða mörk villan tilgreinir. Til dæmis eru beiðnir á mínútu og tókar á mínútu aðskilin mörk. Þú getur náð öðrum mörkunum en verið undir hinum.
Staðfestu hvaða skipulagseining beiðnin notar
Ef þú tilheyrir fleiri en einni skipulagseiningu skaltu staðfesta að beiðnirnar noti rétta skipulagseiningu og verkefni.
Ef API-lykillinn þinn notar sjálfgefna skipulagseiningu skaltu athuga stillingu sjálfgefinnar skipulagseiningar. Mismunandi skipulagseiningar geta haft ólíkt greiðslufyrirkomulag og notkunarstig.
Fækkaðu tímabundnum hraðatakmörkunarvillum
Dreifðu beiðnum og forðastu skyndilegan fjölda þeirra
Dreifðu beiðnum yfir lengri tíma í stað þess að senda margar í einu.
Hraðatakmörkunum má framfylgja á styttri tímabilum en uppgefið bil segir til um. Til dæmis má einnig framfylgja mörkum upp á 60 beiðnir á mínútu á einnar sekúndu tímabilum. Margar beiðnir á stuttum tíma geta því valdið villu þótt meðalnotkunin virðist undir mörkunum á mínútu.
Langar kvaðningar og óþarflega há mörk úttakstóka geta einnig stuðlað að hraðavillum tóka.
Reyndu aftur eftir bið
Ef um tímabundnar hraðatakmörkunarvillur er að ræða:
Athugaðu hvort svarið innihaldi Retry-After-haus.
Ef hausinn inniheldur gildan biðtíma skaltu bíða að minnsta kosti svo lengi áður en þú reynir aftur.
Ef hausinn vantar eða er ógildur skaltu nota stigvaxandi bið með slembiseinkun: lengdu biðina eftir hverja misheppnaða tilraun og bættu við stuttri slembinni bið.
Takmarkaðu bæði fjölda endurtilrauna og heildartímann sem fer í þær.
Opinber OpenAI SDK reyna sjálfkrafa aftur við viðeigandi hraðatakmörkunarvillur og virða Retry-After þegar það er til staðar. Taktu tillit til þessara endurtilrauna áður en þú bætir við annarri endurtilraunarlykkju.
Misheppnaðar beiðnir teljast með í mörkum á mínútu. Stöðug endursending sömu beiðni getur framlengt vandann.
Leiðbeiningar og dæmi um útfærslu er að finna í leiðbeiningum um hraðatakmarkanir API. Farðu yfir öll endurtilraunasöfn frá þriðja aðila áður en þú notar þau í forritinu þínu.
Farðu yfir stærð kvaðningar og úttaks
Fjarlægðu óþarfar leiðbeiningar, endurtekið samhengi og dæmi úr kvaðningunum. Prófaðu endurskoðuðu kvaðninguna til að staðfesta að hún skili enn niðurstöðunni sem þú þarft.
Notaðu færibreytu úttakstóka sem endapunkturinn og líkanið styðja:
Chat Completions notar max_completion_tokens.
Responses notar max_output_tokens.
Ekki stilla mörkin miklu hærri en beiðnin krefst. Þessar færibreytur ná bæði yfir tóka fyrir rök og sýnilegt úttak, svo gerðu ráð fyrir hvoru tveggja þegar rakalíkan er notað.
Farðu yfir notkunarþrepið þitt
Ef villur halda áfram eftir að þú hefur dregið úr skyndilegum álagstoppum og farið yfir tókanotkun skaltu skoða síðuna Takmarkanir til að sjá hvaða leiðir eru í boði til að hækka mörkin þín.
Skipulagsheildin þín færist sjálfkrafa upp á hærra notkunarþrep fyrir greidda notkun þegar heildarkaup hennar á inneignum ná viðmiðunarmörkum Build, Launch og Grow. Á hærri þrepum eru hraðatakmarkanir yfirleitt rýmri. Sjá kröfur fyrir hvert þrep í leiðbeiningunum um hraðatakmarkanir API.
Samþykkt mánaðarleg notkunarmörk þín eru aðskilin frá hraðatakmörkunum fyrir beiðnir og tóka. Ekki ætti að líta á hækkun á öðrum þessara marka sem staðfestingu á því að hin hafi breyst.
Ef vandinn heldur áfram
Áður en málið er sent áfram
Hafðu tiltæk nákvæm villuboð, alla villukóða, viðeigandi auðkenni beiðna, tíma villunnar ásamt tímabelti þínu og viðeigandi mörk sem birtast á reikningnum. Skráðu skrefin sem þú hefur þegar prófað.
Hafðu samband við þjónustuver OpenAI
Hafðu samband við þjónustuver OpenAI í gegnum Hjálparmiðstöðina ef þér tekst ekki að leysa vandann eftir að hafa athugað tilgreind mörk. Ekki láta API-lykla eða önnur auðkenningarleyndarmál fylgja með.