Përmbledhje
Përdorimi i API-së u nënshtrohet kufijve të normës. Këta kufij kufizojnë kërkesat, tokenët ose përdorime të tjera gjatë një periudhe të caktuar.
Një përgjigje 429 mund të tregojë një kufi të përkohshëm të normës, shterimin e bilancit të parapaguar ose një kufi shpenzimesh apo përdorimi. Kontrolloni hollësitë e gabimit para se të riprovoni ose të ndryshoni cilësimet e faturimit.
Identifikoni shkakun
Lexoni mesazhin e gabimit dhe error.code, kur jepet. Gabimet që lidhen me faturimin mund të përdorin ende vlerën më të përgjithshme insufficient_quota për error.type.
| Gabimi ose kodi | Çfarë do të thotë | Çfarë duhet të bëni |
| U arrit kufiri i normës për kërkesat ose tokenët | Kërkesat po tejkalojnë një kufi të zbatueshëm të normës. | Shpërndajini kërkesat në kohë dhe ndiqni udhëzimet e mëposhtme për riprovën. |
| credit_balance_exhausted | Organizatës nuk i kanë mbetur kredite të parapaguara. | Shtoni kredite te cilësimet e faturimit të API-së. |
| organization_usage_limit_exceeded | Organizata arriti kufirin e përdorimit të caktuar nga OpenAI. | Kërkoni miratimin e një kufiri më të lartë përdorimi. |
| organization_spend_limit_exceeded | Organizata arriti kufirin e zbatuar të shpenzimeve. | Rriteni ose hiqeni kufirin, ose prisni rivendosjen mujore. |
| project_spend_limit_exceeded | Projekti arriti kufirin e zbatuar të shpenzimeve. | Rriteni ose hiqeni kufirin e projektit, ose prisni rivendosjen mujore. |
Riprova pas një gabimi faturimi, shpenzimesh ose kuote nuk e rikthen qasjen. Zgjidhni fillimisht problemin e raportuar me bilancin ose kufirin. Zbatimi i ndryshimeve në kufijtë e detyrueshëm të shpenzimeve mund të kërkojë kohë.
Ndryshimi i një kufiri shpenzimesh kërkon 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 të parapaguar 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 zbatueshëm të normës
Shkoni te faqja Kufijtë e organizatës suaj për të shqyrtuar nivelin dhe kufijtë aktualë të përdorimit.
Kufijtë e normës mund të zbatohen në nivel organizate dhe projekti. Ata nuk janë kuota për përdorues individualë. Kufijtë ndryshojnë edhe sipas modelit dhe disa familje modelesh ndajnë të njëjtin kufi.
Kontrolloni cilin kufi identifikon gabimi. Për shembull, kërkesat në minutë dhe tokenët në minutë kanë kufij të veçantë. Mund të arrini njërin ndërkohë që mbeteni nën tjetrin.
Konfirmoni organizatën që përdor kërkesa juaj
Nëse bëni pjesë në disa organizata, konfirmoni që kërkesat tuaja përdorin organizatën dhe projektin e synuar.
Kur çelësi juaj i API-së përdor një organizatë të parazgjedhur, kontrolloni cilësimin e organizatës së parazgjedhur. Organizata të ndryshme mund të kenë mënyra të ndryshme faturimi dhe nivele përdorimi.
Zvogëloni gabimet e përkohshme të kufirit të normës
Shpërndajini kërkesat në kohë dhe shmangni flukset e menjëhershme
Shpërndajini kërkesat në kohë, në vend që të dërgoni një numër të madh 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 në periudha 1-sekondëshe. Prandaj, një fluks i shkurtër mund të shkaktojë gabim edhe nëse përdorimi mesatar duket nën kufirin për minutë.
Kërkesat e gjata dhe kufijtë e panevojshëm të lartë për tokenët e daljes mund të shkaktojnë gjithashtu gabime të normës së tokenëve.
Riprovoni pas një vonese
Për gabimet e përkohshme të kufirit të normës:
Kontrolloni nëse përgjigjja përmban kreun Retry-After.
Nëse kreu përmban një vonesë të vlefshme, prisni të paktën aq gjatë para se të riprovoni.
Nëse kreu mungon ose është i pavlefshëm, përdorni rritje eksponenciale të intervalit me variacion të rastësishëm: zgjateni vonesën pas çdo përpjekjeje të pasuksesshme dhe shtoni një vonesë të vogël të rastësishme.
Kufizoni si numrin e riprovave, ashtu edhe kohën totale të shpenzuar duke riprovuar.
SDK-të zyrtare të OpenAI riprovojnë vetë gabimet e pranueshme të kufirit të normës dhe respektojnë Retry-After kur ai është i pranishëm. Merrini parasysh këto riprova para se të shtoni një cikël tjetër riprovash.
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 dhe shembuj zbatimi, shihni udhëzuesin për kufijtë e normës së API-së. Shqyrtoni çdo bibliotekë riprovash të palëve të treta para se ta përdorni në aplikacionin tuaj.
Shqyrtoni madhësinë e kërkesës dhe të daljes
Hiqni nga kërkesat tuaja udhëzimet e panevojshme, kontekstin e përsëritur dhe shembujt. Testoni kërkesën e rishikuar për të konfirmuar se ende jep rezultatin që ju nevojitet.
Përdorni parametrin e tokenëve të daljes që mbështetet nga pika juaj fundore dhe modeli:
Chat Completions përdor max_completion_tokens.
Responses përdor max_output_tokens.
Shmangni vendosjen e një kufiri shumë më të lartë nga sa i nevojitet kërkesës. Këta parametra përfshijnë tokenët e arsyetimit dhe daljen e dukshme, ndaj merrini parasysh të dyja kur përdorni një model arsyetimi.
Shqyrtoni nivelin tuaj të përdorimit
Nëse gabimet vazhdojnë pasi zvogëloni flukset dhe shqyrtoni përdorimin e tokenëve, kontrolloni faqen Kufijtë për mënyrat e disponueshme për t'i rritur kufijtë.
Me rritjen e shpenzimeve për API-në, OpenAI mund ta kalojë automatikisht një organizatë në një nivel më të lartë përdorimi. Kjo zakonisht rrit kufijtë e normës në shumicën e modeleve.
Kufiri juaj i miratuar i përdorimit mujor është i veçantë nga kufijtë e normës së kërkesave dhe tokenëve. Rritja e njërit nuk duhet konsideruar si konfirmim se ka ndryshuar edhe tjetri.
Nëse problemi vazhdon
Para se ta përshkallëzoni problemin
Mbani gati mesazhin e saktë të gabimit, çdo kod gabimi, ID-të përkatëse të kërkesave, kohën e gabimit bashkë me zonën tuaj kohore dhe kufirin përkatës të shfaqur në llogarinë tuaj. Shënoni hapat që keni provuar tashmë.
Kontaktoni mbështetjen e OpenAI
Kontaktoni mbështetjen e OpenAI përmes qendrës së ndihmës nëse nuk mund ta zgjidhni problemin pasi të keni kontrolluar kufirin e raportuar. Mos përfshini çelësa API-je ose të dhëna të tjera sekrete autentikimi.