Pregled
Na upotrebu API-ja primjenjuju se ograničenja broja zahtjeva. Ta ograničenja određuju dopušteni broj zahtjeva, tokena ili drugih jedinica upotrebe u određenom razdoblju.
Odgovor s kodom 429 može upućivati na privremeno ograničenje broja zahtjeva, potrošena unaprijed uplaćena sredstva ili ograničenje potrošnje ili upotrebe. Provjerite pojedinosti pogreške prije ponovnog pokušaja ili promjene postavki naplate.
Utvrdite uzrok
Pročitajte poruku o pogrešci i vrijednost error.code, ako je navedena. Pogreške povezane s naplatom i dalje mogu imati općenitiju vrijednost insufficient_quota u polju error.type.
| Pogreška ili kod | Što to znači | Što učiniti |
| Dosegnuto je ograničenje broja zahtjeva ili tokena | Zahtjevi premašuju primjenjivo ograničenje broja zahtjeva. | Šaljite zahtjeve u razmacima i slijedite smjernice za ponovne pokušaje u nastavku. |
| credit_balance_exhausted | Organizacija je potrošila sve unaprijed kupljene kredite. | 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 obvezujuće ograničenje potrošnje. | Povećajte ili uklonite ograničenje ili pričekajte njegovo mjesečno poništavanje. |
| project_spend_limit_exceeded | Projekt je dosegnuo obvezujuće ograničenje potrošnje. | Povećajte ili uklonite ograničenje projekta ili pričekajte njegovo mjesečno poništavanje. |
Ponovno slanje zahtjeva nakon pogreške povezane s naplatom, potrošnjom ili kvotom ne vraća pristup. Najprije riješite problem s prijavljenim stanjem sredstava ili ograničenjem. Primjena promjena obvezujućih ograničenja potrošnje može potrajati.
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.
Za kupnju kredita unaprijed pogledajte: Postavljanje i upravljanje naplatom API-ja uz plaćanje unaprijed.
Više o različitim načinima kontrole potrošnje potražite u vodiču za ograničenja potrošnje za API.
Provjerite primjenjiva ograničenja broja zahtjeva
Otvorite stranicu Ograničenja svoje organizacije da biste pregledali njezinu trenutačnu razinu upotrebe i ograničenja.
Ograničenja broja zahtjeva mogu se primjenjivati na razini organizacije i projekta. To nisu kvote za pojedinačne korisnike. Ograničenja se razlikuju i ovisno o modelu, a neke skupine modela dijele isto ograničenje.
Provjerite na koje ograničenje upućuje pogreška. Primjerice, broj zahtjeva u minuti i broj tokena u minuti zasebna su ograničenja. Možete dosegnuti jedno, a pritom ostati ispod drugoga.
Provjerite ograničenja API-ja za generiranje slike
Ograničenja broja zahtjeva za API za generiranje slike ovise o modelu i vašoj razini upotrebe. Odaberite svoj model na stranici s modelima da biste vidjeli njegova ograničenja.
Upute za postavljanje potražite u vodiču za razvojne programere za generiranje slike. Više o razinama upotrebe potražite u vodiču za ograničenja broja zahtjeva za API.
Provjerite koju organizaciju koristi vaš zahtjev
Ako ste član više organizacija, provjerite koriste li vaši zahtjevi željenu organizaciju i projekt.
Ako vaš API ključ koristi zadanu organizaciju, provjerite postavku zadane organizacije. Različite organizacije mogu imati različite uvjete naplate i razine upotrebe.
Smanjite učestalost privremenih pogrešaka zbog ograničenja broja zahtjeva
Šaljite zahtjeve u razmacima i izbjegavajte nagle skokove
Rasporedite zahtjeve tijekom vremena umjesto da ih šaljete mnogo odjednom.
Ograničenja broja zahtjeva mogu se primjenjivati na razdoblja kraća od prikazanog intervala. Primjerice, ograničenje od 60 zahtjeva u minuti može se primjenjivati i na razdoblja od jedne sekunde. Kratak nagli porast broja zahtjeva 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 velik dopušteni broj izlaznih tokena također mogu pridonijeti pogreškama zbog ograničenja broja tokena.
Pričekajte prije ponovnog pokušaja
Za privremene pogreške zbog ograničenja broja zahtjeva:
Provjerite sadrži li odgovor zaglavlje Retry-After.
Ako zaglavlje sadrži valjano vrijeme čekanja, pričekajte barem toliko prije ponovnog pokušaja.
Ako zaglavlje nedostaje ili nije valjano, primijenite eksponencijalno produljivanje vremena čekanja uz nasumično odstupanje: povećajte vrijeme čekanja nakon svakog neuspjelog pokušaja i dodajte kratku nasumičnu odgodu.
Ograničite i broj ponovnih pokušaja i ukupno vrijeme provedeno u njima.
Službeni SDK-ovi tvrtke OpenAI već ponavljaju zahtjeve kod odgovarajućih pogrešaka zbog ograničenja broja zahtjeva i poštuju Retry-After kada je prisutan. Uzmite te ponovne pokušaje u obzir prije dodavanja nove petlje za ponavljanje zahtjeva.
Neuspjeli zahtjevi uračunavaju se u ograničenja po minuti. Neprekidno ponovno slanje istog zahtjeva može produljiti trajanje problema.
Smjernice za implementaciju i primjere potražite u vodiču za ograničenja broja zahtjeva za API. Provjerite svaku biblioteku treće strane za ponavljanje zahtjeva prije nego što je upotrijebite u svojoj aplikaciji.
Provjerite duljinu upita i izlaznog sadržaja
Iz upita uklonite nepotrebne upute, ponovljeni kontekst i primjere. Testirajte izmijenjeni upit kako biste potvrdili da i dalje daje željeni rezultat.
Upotrijebite parametar za izlazne tokene koji podržavaju vaša krajnja točka i model:
Chat Completions koristi max_completion_tokens.
Responses koristi max_output_tokens.
Izbjegavajte postavljanje znatno većeg dopuštenog broja tokena nego što je potrebno za zahtjev. Ti parametri obuhvaćaju i tokene za rasuđivanje i vidljivi izlazni sadržaj, pa pri upotrebi modela za rasuđivanje ostavite dovoljno prostora za oboje.
Provjerite svoju razinu upotrebe
Ako se pogreške nastave nakon što smanjite nagle skokove broja zahtjeva i provjerite upotrebu tokena, na stranici Ograničenja provjerite dostupne načine povećanja ograničenja.
Plaćena razina upotrebe vaše organizacije automatski se povećava kada ukupna vrijednost kupljenih kredita dosegne pragove za razine Build, Launch i Grow. Više razine u pravilu omogućuju viša ograničenja broja zahtjeva. Uvjete za pojedine razine potražite u vodiču za ograničenja broja zahtjeva za API.
Vaše odobreno mjesečno ograničenje upotrebe odvojeno je od ograničenja broja zahtjeva i tokena. Povećanje jednog ograničenja ne znači da se promijenilo i drugo.
Ako se problem nastavi
Prije obraćanja podršci
Pripremite točnu poruku o pogrešci, kod pogreške ako postoji, relevantne ID-jeve zahtjeva, vrijeme pogreške s vremenskom zonom i odgovarajuće ograničenje prikazano na vašem računu. Zabilježite korake koje ste već pokušali.
Obratite se podršci tvrtke OpenAI
Obratite se podršci tvrtke OpenAI putem Centra za pomoć ako ne uspijete riješiti problem nakon provjere prijavljenog ograničenja. Nemojte slati API ključeve ni druge tajne podatke za autentifikaciju.