Pregled
Na upotrebu API-ja primjenjuju se ograničenja broja zahtjeva. Ta ograničenja određuju dopušteni broj zahtjeva, tokena ili opseg druge upotrebe u određenom razdoblju.
Odgovor 429 može upućivati na privremeno ograničenje broja zahtjeva, potrošen unaprijed plaćeni saldo ili ograničenje potrošnje odnosno upotrebe. Prije ponovnog pokušaja ili promjene postavki naplate provjerite pojedinosti o pogrešci.
Utvrdite uzrok
Pročitajte poruku o pogrešci i error.code, ako je naveden. Pogreške povezane s naplatom i dalje mogu imati općenitiju vrijednost error.type: insufficient_quota.
| Pogreška ili kôd | Što to znači | Što učiniti |
| Dosegnuto je ograničenje broja zahtjeva ili tokena | Zahtjevi premašuju primjenjivo ograničenje broja zahtjeva. | Rasporedite zahtjeve i slijedite smjernice za ponovne pokušaje u nastavku. |
| credit_balance_exhausted | Organizacija više nema unaprijed plaćenih kredita. | Dodajte kredite u postavkama naplate API-ja. |
| organization_usage_limit_exceeded | Organizacija je dosegnula ograničenje upotrebe koje joj je dodijelio OpenAI. | Zatražite odobrenje višeg ograničenja upotrebe. |
| organization_spend_limit_exceeded | Organizacija je dosegnula obvezno ograničenje potrošnje. | Povećajte ili uklonite ograničenje ili pričekajte mjesečno poništavanje. |
| project_spend_limit_exceeded | Projekt je dosegnuo obvezno ograničenje potrošnje. | Povećajte ili uklonite ograničenje projekta ili pričekajte mjesečno poništavanje. |
Ponovni pokušaj nakon pogreške naplate, potrošnje ili kvote neće vratiti pristup. Najprije riješite problem s navedenim saldom ili ograničenjem. Može proći neko vrijeme prije nego što se primijene promjene obveznih ograničenja potrošnje.
Za promjenu ograničenja potrošnje potrebna je dozvola za upravljanje postavkama odgovarajuće organizacije ili projekta. Ako nemate pristup, obratite se osobi koja upravlja tim postavkama.
Informacije o kupnji unaprijed plaćenih kredita potražite u članku: Postavljanje unaprijed plaćene naplate API-ja i upravljanje njome.
Informacije o različitim kontrolama potrošnje potražite u vodiču za ograničenja potrošnje API-ja.
Provjerite primjenjiva ograničenja broja zahtjeva
Otvorite stranicu Ograničenja svoje organizacije kako biste pregledali njezinu trenutačnu razinu upotrebe i ograničenja.
Ograničenja broja zahtjeva mogu se primjenjivati na razini organizacije i projekta. To nisu dopuštenja za pojedinačne korisnike. Ograničenja se razlikuju i prema modelu, a neke obitelji modela dijele isto ograničenje.
Provjerite koje ograničenje navodi pogreška. Na primjer, broj zahtjeva u minuti i broj tokena u minuti zasebna su ograničenja. Jedno možete dosegnuti dok ste još ispod drugoga.
Potvrdite organizaciju koju vaš zahtjev upotrebljava
Ako pripadate većem broju organizacija, provjerite upotrebljavaju li vaši zahtjevi željenu organizaciju i projekt.
Ako vaš ključ API-ja upotrebljava zadanu organizaciju, provjerite postavku zadane organizacije. Različite organizacije mogu imati različite načine naplate i razine upotrebe.
Smanjite broj privremenih pogrešaka ograničenja broja zahtjeva
Rasporedite zahtjeve i izbjegavajte nagle skokove
Rasporedite zahtjeve tijekom vremena umjesto da ih velik broj šaljete odjednom.
Ograničenja broja zahtjeva mogu se primjenjivati tijekom kraćih razdoblja od prikazanog intervala. Na primjer, ograničenje od 60 zahtjeva u minuti može se primjenjivati i na razdoblja od jedne sekunde. Kratkotrajan skok stoga može izazvati pogrešku čak i ako je vaša prosječna upotreba naizgled ispod ograničenja po minuti.
Dugi upiti i nepotrebno visoka dopuštenja broja izlaznih tokena također mogu pridonijeti pogreškama ograničenja broja tokena.
Pokušajte ponovno nakon odgode
Za privremene pogreške ograničenja broja zahtjeva:
Provjerite postoji li zaglavlje odgovora Retry-After.
Ako zaglavlje sadrži valjanu odgodu, pričekajte barem toliko prije ponovnog pokušaja.
Ako zaglavlje nedostaje ili nije valjano, primijenite eksponencijalno produljenje čekanja s nasumičnim odstupanjem: povećajte odgodu nakon svakog neuspješnog pokušaja i dodajte kratku nasumičnu odgodu.
Ograničite broj ponovnih pokušaja i ukupno vrijeme utrošeno na njih.
Službeni OpenAI SDK-ovi već ponavljaju zahtjeve za prikladne pogreške ograničenja broja zahtjeva i poštuju Retry-After kada je prisutan. Uzmite te ponovne pokušaje u obzir prije dodavanja još jedne petlje za ponovno pokušavanje.
Neuspješni zahtjevi ubrajaju se u ograničenja po minuti. Neprestano ponovno slanje istog zahtjeva može produljiti problem.
Smjernice i primjere implementacije potražite u vodiču za ograničenja broja zahtjeva API-ja. Prije upotrebe u aplikaciji pregledajte svaku biblioteku treće strane za ponovne pokušaje.
Pregledajte veličinu upita i izlaza
Iz upita uklonite nepotrebne upute, ponovljeni kontekst i primjere. Testirajte izmijenjeni upit kako biste potvrdili da i dalje daje potreban rezultat.
Upotrijebite parametar izlaznih tokena koji podržavaju vaša krajnja točka i model:
Chat Completions upotrebljava max_completion_tokens.
Responses upotrebljava max_output_tokens.
Nemojte postavljati dopuštenje koje je znatno veće nego što zahtjev iziskuje. Ti parametri obuhvaćaju tokene rasuđivanja i vidljivi izlaz, stoga pri upotrebi modela za rasuđivanje ostavite dovoljno prostora za oboje.
Pregledajte svoju razinu upotrebe
Ako se pogreške nastave nakon što smanjite nagle skokove i pregledate upotrebu tokena, na stranici Ograničenja provjerite dostupne načine povećanja ograničenja.
Kako se potrošnja za API povećava, OpenAI može automatski premjestiti organizaciju na višu razinu upotrebe. Time se obično povećavaju ograničenja broja zahtjeva za većinu modela.
Vaše odobreno mjesečno ograničenje upotrebe odvojeno je od ograničenja broja zahtjeva i tokena. Povećanje jednog ne treba smatrati potvrdom da se promijenilo i drugo.
Ako se problem nastavi
Prije prosljeđivanja problema
Pripremite točnu poruku o pogrešci, sve kodove pogrešaka, relevantne ID-ove zahtjeva, vrijeme pogreške s vremenskom zonom i relevantno ograničenje prikazano na vašem računu. Zabilježite korake koje ste već isprobali.
Obratite se podršci tvrtke OpenAI
Ako nakon provjere prijavljenog ograničenja ne možete riješiti problem, obratite se podršci tvrtke OpenAI putem Centra za pomoć. Nemojte navoditi ključeve API-ja ni druge tajne podatke za provjeru autentičnosti.