Yfirlit
Hraðatakmarkanir gilda um notkun API. Þær takmarka fjölda beiðna, tóka eða aðra notkun á tilteknu tímabili.
Svar með stöðukóðanum 429 getur bent til tímabundinnar hraðatakmörkunar, uppurinnrar fyrirframgreiddrar inneignar eða þess að kostnaðar- 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 villuskilaboðin og skoðaðu error.code ef það fylgir með. Greiðslutengdar villur geta eftir sem áður haft almenna gildið insufficient_quota í error.type.
| Villa eða kóði | Merking | Viðbrögð |
| Hraðatakmörkun fyrir beiðnir eða tóka náð | Beiðnir fara yfir gildandi hraðatakmörkun. | Dreifðu beiðnum yfir tíma og fylgdu leiðbeiningunum um endurtilraunir hér að neðan. |
| credit_balance_exhausted | Fyrirtækið á engar fyrirframgreiddar inneignir eftir. | Bættu við inneignum í greiðslustillingum API. |
| organization_usage_limit_exceeded | Fyrirtækið hefur náð þeim notkunarmörkum sem OpenAI úthlutaði því. | Óskaðu eftir samþykki fyrir hærri notkunarmörkum. |
| organization_spend_limit_exceeded | Fyrirtækið hefur náð virkum kostnaðarmörkum sínum. | Hækkaðu mörkin eða fjarlægðu þau, eða bíddu eftir mánaðarlegri endurstillingu. |
| project_spend_limit_exceeded | Verkefnið hefur náð virkum kostnaðarmörkum sínum. | Hækkaðu mörk verkefnisins eða fjarlægðu þau, eða bíddu eftir mánaðarlegri endurstillingu. |
Að reyna aftur eftir villu vegna greiðslna, kostnaðar eða kvóta endurheimtir ekki aðgang. Leystu fyrst úr stöðu inneignar eða þeim mörkum sem villan vísar til. Breytingar á virkum kostnaðarmörkum geta tekið tíma að taka gildi.
Til að breyta kostnaðarmörkum þarftu heimild til að stjórna viðeigandi stillingum fyrirtækisins eða verkefnisins. Ef þú hefur ekki aðgang skaltu biðja þann sem sér um þessar stillingar um aðstoð.
Um kaup á fyrirframgreiddum inneignum, sjá: Uppsetning og umsjón fyrirframgreiðslna fyrir API.
Upplýsingar um mismunandi leiðir til að stýra kostnaði eru í leiðbeiningum um kostnaðarmörk API.
Skoðaðu gildandi hraðatakmarkanir
Farðu á síðuna Mörk fyrir fyrirtækið þitt til að skoða núverandi notkunarþrep og mörk þess.
Hraðatakmarkanir geta gilt bæði fyrir fyrirtæki og verkefni. Þær eru ekki sérstakur kvóti fyrir hvern notanda. Mörkin eru líka mismunandi eftir líkönum og sumar líkanafjölskyldur deila mörkum.
Athugaðu hvaða mörk villan vísar til. Til dæmis gilda aðskilin mörk um fjölda beiðna á mínútu og fjölda tóka á mínútu. Þú getur náð öðrum mörkunum þótt þú sért enn undir hinum.
Skoðaðu API-takmarkanir fyrir myndun mynda
Hraðatakmarkanir API fyrir myndun mynda ráðast af líkaninu og notkunarþrepinu þínu. Veldu líkanið þitt á líkansíðunni til að sjá takmarkanir þess.
Leiðbeiningar um uppsetningu er að finna í leiðbeiningum fyrir forritara um myndun mynda. Nánari upplýsingar um notkunarþrep eru í leiðbeiningum um hraðatakmarkanir API.
Staðfestu hvaða fyrirtæki beiðnin tengist
Ef þú tilheyrir fleiri en einu fyrirtæki skaltu staðfesta að beiðnirnar tengist réttu fyrirtæki og verkefni.
Ef API-lykillinn þinn notar sjálfgefið fyrirtæki skaltu athuga stillinguna fyrir sjálfgefið fyrirtæki. Greiðslufyrirkomulag og notkunarþrep geta verið mismunandi eftir fyrirtækjum.
Fækkaðu tímabundnum villum vegna hraðatakmarkana
Dreifðu beiðnum yfir tíma og forðastu álagstoppa
Dreifðu beiðnum yfir tíma í stað þess að senda margar í einu.
Hraðatakmarkanir geta verið framfylgt yfir styttri tímabil en það sem birtist. Til dæmis geta mörk upp á 60 beiðnir á mínútu einnig verið framfylgt yfir einnar sekúndu tímabil. Stuttur álagstoppur getur því valdið villu þótt meðalnotkun þín virðist vera undir mínútumörkunum.
Langar kvaðningar og óþarflega há mörk fyrir úttakstóka geta einnig stuðlað að villum vegna hraðatakmarkana tóka.
Bíddu áður en þú reynir aftur
Við tímabundnar villur vegna hraðatakmarkana:
Athugaðu hvort svarið innihaldi Retry-After-haus.
Ef hausinn tilgreinir 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 veldisvaxandi biðtíma með slembibreytingu: lengdu biðina eftir hverja misheppnaða tilraun og bættu við stuttum, tilviljanakenndum biðtíma.
Takmarkaðu bæði fjölda endurtilrauna og heildartímann sem fer í þær.
Opinber SDK-söfn OpenAI reyna nú þegar aftur við viðeigandi villur vegna hraðatakmarkana og fylgja Retry-After þegar hausinn er til staðar. Taktu tillit til þessara endurtilrauna áður en þú bætir við annarri endurtilraunalykkju.
Misheppnaðar beiðnir teljast með í mínútumörkum. Sífelld endursending sömu beiðni getur lengt þann tíma sem vandamálið varir.
Leiðbeiningar um útfærslu og dæmi eru í leiðbeiningum um hraðatakmarkanir API. Farðu yfir endurtilraunasöfn frá þriðja aðila áður en þú notar þau í forritinu þínu.
Farðu yfir lengd kvaðninga og úttaks
Fjarlægðu óþarfar leiðbeiningar, endurteknar samhengisupplýsingar og dæmi úr kvaðningunum þínum. Prófaðu endurskoðuðu kvaðninguna til að staðfesta að hún skili enn þeirri niðurstöðu sem þú þarft.
Notaðu færibreytuna fyrir úttakstóka sem endapunkturinn og líkanið þitt styðja:
Chat Completions notar max_completion_tokens.
Responses notar max_output_tokens.
Forðastu að setja mörkin mun hærra 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 þú notar rakalíkan.
Skoðaðu notkunarþrepið þitt
Ef villur halda áfram eftir að þú dregur úr álagstoppum og ferð yfir tókanotkun skaltu skoða síðuna Mörk til að sjá hvaða leiðir eru í boði til að hækka mörkin þín.
Fyrirtækið þitt færist sjálfkrafa á hærra greitt notkunarþrep þegar heildarkaup þess á inneignum ná viðmiðunarmörkum Build, Launch og Grow. Hærri þrep veita yfirleitt hærri hraðatakmarkanir. Sjá kröfur fyrir hvert þrep í leiðbeiningum 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. Hækkun annarra markanna staðfestir ekki að hin hafi breyst.
Ef vandamálið er viðvarandi
Áður en þú leitar frekari aðstoðar
Hafðu eftirfarandi við höndina: nákvæm villuskilaboð, villukóða ef einhver er, auðkenni viðeigandi beiðna, tímasetningu villunnar ásamt tímabelti og viðeigandi mörk sem birtast á reikningnum þínum. Skráðu hvað þú hefur þegar prófað.
Hafðu samband við þjónustuver OpenAI
Hafðu samband við þjónustuver OpenAI í gegnum Hjálparmiðstöðina ef þú getur ekki leyst vandamálið eftir að hafa skoðað mörkin sem villan vísar til. Ekki láta API-lykla eða önnur leynileg auðkenningargögn fylgja með.