Përmbledhje
Përdorimi i API-së u nënshtrohet kufijve të normës. Këta kufij kufizojnë kërkesat, tokenët ose forma të tjera përdorimi gjatë një periudhe të caktuar.
Një përgjigje 429 mund të tregojë se është arritur përkohësisht një kufi i normës, është shteruar bilanci i parapaguar ose është arritur një kufi shpenzimesh apo përdorimi. Kontrolloni hollësitë e gabimit përpara se të provoni sërish ose të ndryshoni cilësimet e faturimit.
Identifikoni shkakun
Lexoni mesazhin e gabimit dhe error.code, kur jepet. Edhe gabimet që lidhen me faturimin mund të përdorin vlerën më të përgjithshme insufficient_quota për error.type.
| Gabimi ose kodi | Çfarë do të thotë | Çfarë të bëni |
| Është arritur kufiri i normës për kërkesat ose tokenët | Kërkesat po tejkalojnë një kufi të normës që zbatohet për to. | Dërgojini kërkesat me intervale dhe ndiqni udhëzimet e mëposhtme për riprovimin. |
| credit_balance_exhausted | Organizatës nuk i kanë mbetur më kredite të parapaguara. | Shtoni kredite te cilësimet e faturimit të API-së. |
| organization_usage_limit_exceeded | Organizata ka arritur kufirin e përdorimit të caktuar nga OpenAI. | Kërkoni miratimin e një kufiri më të lartë përdorimi. |
| organization_spend_limit_exceeded | Organizata ka arritur kufirin e detyrueshëm të shpenzimeve. | Rriteni ose hiqeni kufirin, ose prisni rivendosjen mujore. |
| project_spend_limit_exceeded | Projekti ka arritur kufirin e detyrueshëm të shpenzimeve. | Rriteni ose hiqeni kufirin e projektit, ose prisni rivendosjen mujore. |
Riprovimi pas një gabimi faturimi, shpenzimesh ose kuote nuk e rikthen qasjen. Zgjidhni fillimisht problemin me bilancin ose kufirin e raportuar. Ndryshimet në kufijtë e detyrueshëm të shpenzimeve mund të kërkojnë kohë për të hyrë në fuqi.
Për të ndryshuar një kufi shpenzimesh, duhet të keni leje për të menaxhuar cilësimet përkatëse të organizatës ose projektit. Nëse nuk keni qasje, kërkojini ndihmë personit që menaxhon ato cilësime.
Për blerjet e krediteve të parapaguara, shihni: Konfigurimi dhe menaxhimi i faturimit me parapagim të API-së.
Për mënyrat e ndryshme të kontrollit të shpenzimeve, shihni udhëzuesin për kufijtë e shpenzimeve të API-së.
Kontrolloni kufijtë e normës që zbatohen
Shkoni te faqja e kufijve të organizatës suaj për të parë nivelin aktual të përdorimit dhe kufijtë e saj.
Kufijtë e normës mund të zbatohen në nivel organizate dhe projekti. Ato nuk janë kuota individuale për përdoruesit. Kufijtë ndryshojnë gjithashtu sipas modelit dhe disa familje modelesh kanë një kufi të përbashkët.
Kontrolloni cilin kufi identifikon gabimi. Për shembull, kërkesat për minutë dhe tokenët për minutë kanë kufij të veçantë. Mund të arrini njërin kufi ndërkohë që mbeteni nën tjetrin.
Kontrolloni kufijtë e API-së për gjenerim imazhi
Kufijtë e normës së API-së për gjenerim imazhi varen nga modeli dhe niveli juaj i përdorimit. Zgjidhni modelin tuaj në faqen e modeleve për të parë kufijtë e tij.
Për udhëzime konfigurimi, shihni udhëzuesin për zhvilluesit për gjenerim imazhi. Për më shumë rreth niveleve të përdorimit, shihni udhëzuesin për kufijtë e normës së API-së.
Verifikoni organizatën që përdor kërkesa juaj
Nëse jeni anëtar i disa organizatave, verifikoni që kërkesat tuaja përdorin organizatën dhe projektin e synuar.
Kur çelësi juaj API përdor një organizatë të parazgjedhur, kontrolloni cilësimin e organizatës së parazgjedhur. Organizata të ndryshme mund të kenë marrëveshje faturimi dhe nivele përdorimi të ndryshme.
Pakësoni gabimet e përkohshme të kufirit të normës
Dërgojini kërkesat me intervale dhe shmangni grumbullimet
Shpërndajini kërkesat në kohë në vend që të dërgoni shumë prej tyre njëherësh.
Kufijtë e normës mund të zbatohen për periudha më të shkurtra se intervali i shfaqur. Për shembull, një kufi prej 60 kërkesash në minutë mund të zbatohet edhe për periudha 1-sekondëshe. Prandaj, dërgimi i shumë kërkesave brenda një kohe të shkurtër mund të shkaktojë një gabim, edhe nëse përdorimi juaj mesatar duket se është nën kufirin për minutë.
Kërkesat e gjata dhe caktimi i një numri të lejuar tokenësh dalës shumë më të madh se sa nevojitet mund të kontribuojnë gjithashtu në gabimet e normës së tokenëve.
Prisni pak përpara se të provoni sërish
Për gabimet e përkohshme të kufirit të normës:
Kontrolloni nëse përgjigjja përmban një fushë të kreut Retry-After.
Nëse kjo fushë përmban një kohë pritjeje të vlefshme, prisni të paktën aq përpara se të provoni sërish.
Nëse fusha mungon ose është e pavlefshme, përdorni pritje me rritje eksponenciale dhe variacion të rastësishëm: rritni kohën e pritjes pas çdo përpjekjeje të pasuksesshme dhe shtoni një vonesë të vogël të rastësishme.
Kufizoni si numrin e riprovimeve, ashtu edhe kohën totale të shpenzuar për to.
SDK-të zyrtare të OpenAI kryejnë tashmë riprovime për gabimet e kufirit të normës që e lejojnë këtë dhe respektojnë Retry-After kur është i pranishëm. Merrini parasysh këto riprovime përpara se të shtoni një cikël tjetër riprovimi.
Edhe kërkesat e pasuksesshme llogariten në kufijtë për minutë. Ridërgimi i vazhdueshëm i së njëjtës kërkesë mund ta zgjasë problemin.
Për udhëzime zbatimi dhe shembuj, shihni udhëzuesin për kufijtë e normës së API-së. Shqyrtoni çdo bibliotekë riprovimi nga palë të treta përpara se ta përdorni në aplikacionin tuaj.
Shqyrtoni gjatësinë e kërkesës dhe të përgjigjes
Hiqni nga kërkesat tuaja udhëzimet dhe shembujt e panevojshëm, si dhe kontekstin e përsëritur. Testoni kërkesën e rishikuar për t'u siguruar që ende jep rezultatin që ju nevojitet.
Përdorni parametrin e tokenëve dalës që mbështetet nga pika juaj fundore dhe modeli juaj:
Chat Completions përdor max_completion_tokens.
Responses përdor max_output_tokens.
Shmangni caktimin e një numri të lejuar shumë më të madh se sa i nevojitet kërkesës. Këta parametra përfshijnë si tokenët e arsyetimit, ashtu edhe përgjigjen e dukshme, ndaj lini hapësirë për të dyja kur përdorni një model arsyetimi.
Shqyrtoni nivelin tuaj të përdorimit
Nëse gabimet vazhdojnë pasi keni pakësuar kërkesat e grumbulluara dhe keni shqyrtuar përdorimin e tokenëve, kontrolloni faqen e kufijve për mënyrat e disponueshme për t'i rritur kufijtë tuaj.
Niveli i përdorimit me pagesë i organizatës suaj rritet automatikisht kur shuma totale e blerjeve të krediteve arrin pragjet e niveleve Build, Launch dhe Grow. Nivelet më të larta zakonisht ofrojnë kufij më të lartë të normës. Shihni udhëzuesin për kufijtë e normës së API-së për kushtet e niveleve.
Kufiri juaj i miratuar i përdorimit mujor është i veçantë nga kufijtë e normës për kërkesat dhe tokenët. Rritja e njërit nuk duhet marrë si konfirmim se ka ndryshuar edhe tjetri.
Nëse problemi vazhdon
Përpara se të kërkoni ndihmë të mëtejshme
Mbani gati mesazhin e saktë të gabimit, çdo kod gabimi, ID-të përkatëse të kërkesave, orën kur ndodhi gabimi së bashku me zonën tuaj kohore dhe kufirin përkatës që shfaqet në llogarinë tuaj. Shënoni hapat që keni provuar tashmë.
Kontaktoni shërbimin e mbështetjes së OpenAI
Kontaktoni shërbimin e mbështetjes së OpenAI përmes qendrës së ndihmës nëse nuk arrini ta zgjidhni problemin pasi të keni kontrolluar kufirin e raportuar. Mos përfshini çelësa API ose të dhëna të tjera sekrete autentikimi.