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ð.
Skoðaðu notkunarstigið þitt
Ef villurnar halda áfram eftir að þú dregur úr skyndilegum beiðnafjölda og skoðar tókanotkun skaltu kanna leiðir til að hækka mörkin á Mörk-síðunni.
Þegar útgjöld vegna API aukast getur OpenAI sjálfkrafa fært skipulagseiningu upp á hærra notkunarstig. Það hækkar yfirleitt hraðatakmarkanir hjá flestum líkönum.
Samþykkt mánaðarlegt notkunarmark þitt er aðskilið frá hraðatakmörkunum beiðna og tóka. Hækkun annars markanna staðfestir ekki að hitt 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ð.