Pregled
Za uporabo API-ja veljajo omejitve hitrosti. Te omejitve določajo dovoljeno število zahtev, žetonov ali obseg druge uporabe v določenem obdobju.
Odgovor s kodo 429 lahko pomeni začasno omejitev hitrosti, izčrpano predplačniško dobroimetje ali doseženo omejitev porabe ali uporabe. Pred ponovnim poskusom ali spreminjanjem nastavitev obračunavanja preverite podrobnosti napake.
Ugotovite vzrok
Preberite sporočilo o napaki in vrednost error.code, če je navedena. Tudi pri napakah, povezanih z obračunavanjem, je lahko v polju error.type navedena splošnejša vrednost insufficient_quota.
| Napaka ali koda | Kaj pomeni | Kaj storiti |
| Dosežena omejitev hitrosti za zahteve ali žetone | Zahteve presegajo veljavno omejitev hitrosti. | Zahteve pošiljajte v časovnih presledkih in upoštevajte spodnja navodila za ponovne poskuse. |
| credit_balance_exhausted | Organizacija nima več predplačniških točk. | Dodajte točke v nastavitvah obračunavanja API-ja. |
| organization_usage_limit_exceeded | Organizacija je dosegla omejitev uporabe, ki ji jo je določil OpenAI. | Zaprosite za odobritev višje omejitve uporabe. |
| organization_spend_limit_exceeded | Organizacija je dosegla svojo strogo omejitev porabe. | Zvišajte ali odstranite omejitev oziroma počakajte na mesečno ponastavitev. |
| project_spend_limit_exceeded | Projekt je dosegel svojo strogo omejitev porabe. | Zvišajte ali odstranite omejitev projekta oziroma počakajte na mesečno ponastavitev. |
Ponovni poskus ob napaki, povezani z obračunavanjem, porabo ali kvoto, ne obnovi dostopa. Najprej odpravite težavo z dobroimetjem ali omejitvijo, navedeno v napaki. Spremembe strogih omejitev porabe lahko začnejo veljati z zamikom.
Za spremembo omejitve porabe potrebujete dovoljenje za upravljanje nastavitev zadevne organizacije ali projekta. Če nimate dostopa, se obrnite na osebo, ki upravlja te nastavitve.
Za nakup predplačniških točk glejte: Nastavitev in upravljanje predplačniškega obračunavanja API-ja.
Različne možnosti nadzora porabe so opisane v vodniku o omejitvah porabe za API.
Preverite veljavne omejitve hitrosti
Na strani z omejitvami svoje organizacije si oglejte njen trenutni razred uporabe in omejitve.
Omejitve hitrosti lahko veljajo na ravni organizacije in projekta. Ne gre za kvote posameznih uporabnikov. Omejitve se razlikujejo tudi glede na model, nekatere družine modelov pa imajo skupno omejitev.
Preverite, katera omejitev je navedena v napaki. Število zahtev na minuto in število žetonov na minuto sta na primer ločeni omejitvi. Eno lahko dosežete, medtem ko druge še niste.
Preverite omejitve API-ja za generiranje slik
Omejitve hitrosti API-ja za generiranje slik so odvisne od modela in vašega razreda uporabe. Na strani z modeli izberite svoj model, da si ogledate njegove omejitve.
Navodila za nastavitev najdete v vodniku za razvijalce o generiranju slik. Več o razredih uporabe najdete v vodniku o omejitvah hitrosti API-ja.
Preverite, katero organizacijo uporablja vaša zahteva
Če ste član več organizacij, preverite, ali vaše zahteve uporabljajo želeno organizacijo in projekt.
Če vaš ključ API uporablja privzeto organizacijo, preverite nastavitev privzete organizacije. Organizacije imajo lahko različne dogovore o obračunavanju in različne razrede uporabe.
Zmanjšajte število začasnih napak zaradi omejitve hitrosti
Zahteve pošiljajte enakomerno in se izogibajte sunkovitim povečanjem
Zahteve razporedite skozi čas, namesto da jih pošljete veliko hkrati.
Omejitve hitrosti se lahko uveljavljajo v krajših obdobjih od prikazanega intervala. Omejitev 60 zahtev na minuto se lahko na primer uveljavlja tudi v enosekundnih obdobjih. Kratkotrajno povečanje števila zahtev lahko zato sproži napako, tudi če je vaša povprečna uporaba videti nižja od omejitve na minuto.
K napakam zaradi omejitve hitrosti za žetone lahko prispevajo tudi dolgi pozivi in po nepotrebnem visoko nastavljeno dovoljeno število izhodnih žetonov.
Pred ponovnim poskusom počakajte
Pri začasnih napakah zaradi omejitve hitrosti:
Preverite, ali odgovor vsebuje glavo Retry-After.
Če glava vsebuje veljaven čas čakanja, pred ponovnim poskusom počakajte vsaj toliko časa.
Če glava manjka ali ni veljavna, uporabite eksponentno podaljševanje čakanja z naključnim zamikom: po vsakem neuspešnem poskusu podaljšajte čakanje in dodajte kratek naključni zamik.
Omejite tako število ponovnih poskusov kot skupni čas, ki ga porabite zanje.
Uradni SDK-ji OpenAI že samodejno ponavljajo zahteve ob napakah zaradi omejitve hitrosti, pri katerih je ponovni poskus smiseln, in upoštevajo glavo Retry-After, kadar je prisotna. Te ponovne poskuse upoštevajte, preden dodate še eno zanko za ponavljanje zahtev.
Tudi neuspešne zahteve se štejejo v omejitve na minuto. Nenehno ponovno pošiljanje iste zahteve lahko podaljša trajanje težave.
Navodila za implementacijo in primere najdete v vodniku o omejitvah hitrosti API-ja. Preden v aplikaciji uporabite knjižnico tretje osebe za ponavljanje zahtev, jo preverite.
Preverite dolžino pozivov in izhodnih podatkov
Iz pozivov odstranite nepotrebna navodila, ponavljajoči se kontekst in primere. Preizkusite spremenjeni poziv in preverite, ali še vedno daje želeni rezultat.
Uporabite parameter za izhodne žetone, ki ga podpirata vaša končna točka in model:
Chat Completions uporablja max_completion_tokens.
Responses uporablja max_output_tokens.
Ne nastavite dovoljenega števila žetonov bistveno višje, kot ga zahteva potrebuje. Ta parametra zajemata tako žetone za sklepanje kot vidne izhodne podatke, zato pri uporabi modela sklepanja predvidite dovolj žetonov za oboje.
Preverite svoj razred uporabe
Če se napake nadaljujejo tudi po tem, ko zmanjšate sunkovita povečanja števila zahtev in preverite porabo žetonov, na strani z omejitvami preverite možnosti za zvišanje omejitev.
Plačljivi razred uporabe vaše organizacije se samodejno nadgradi, ko skupna vrednost njenih nakupov točk doseže pragove za razrede Build, Launch in Grow. Višji razredi praviloma omogočajo višje omejitve hitrosti. Pogoje za posamezne razrede najdete v vodniku o omejitvah hitrosti API-ja.
Vaša odobrena mesečna omejitev uporabe je ločena od omejitev hitrosti za zahteve in žetone. Zvišanje ene vrste omejitev ne pomeni, da so se spremenile tudi druge.
Če se težava nadaljuje
Preden se obrnete na podporo
Pripravite natančno besedilo sporočila o napaki, morebitno kodo napake, ID-je zadevnih zahtev, čas napake s časovnim pasom ter ustrezno omejitev, prikazano v vašem računu. Zabeležite korake, ki ste jih že preizkusili.
Obrnite se na podporo OpenAI
Če težave po preverjanju navedene omejitve ne morete odpraviti, se prek Centra za pomoč obrnite na podporo OpenAI. Ne vključujte ključev API ali drugih tajnih podatkov za preverjanje pristnosti.