Áttekintés
Az API használatára használati korlátok vonatkoznak. Ezek meghatározott időszakon belül korlátozzák a kérések, a tokenek vagy az egyéb felhasznált erőforrások mennyiségét.
A 429-es válasz átmeneti használati korlátot, kimerült előre fizetett egyenleget, illetve költési vagy használati korlátot jelezhet. Mielőtt újrapróbálkozol vagy módosítod a számlázási beállításokat, ellenőrizd a hiba részleteit.
Azonosítsd az okot
Olvasd el a hibaüzenetet és az error.code értékét, ha szerepel a válaszban. Számlázással kapcsolatos hibáknál is szerepelhet az általánosabb insufficient_quota érték az error.type mezőben.
| Hiba vagy hibakód | Jelentése | Teendő |
| Elérted a kérésekre vagy tokenekre vonatkozó használati korlátot | A kérések túllépik valamelyik érvényes használati korlátot. | Ütemezd egyenletesen a kéréseket, és kövesd az alábbi újrapróbálkozási útmutatást. |
| credit_balance_exhausted | A szervezet előre fizetett kreditjei elfogytak. | Vásárolj krediteket az API számlázási beállításaiban. |
| organization_usage_limit_exceeded | A szervezet elérte az OpenAI által meghatározott használati korlátját. | Kérd magasabb használati korlát jóváhagyását. |
| organization_spend_limit_exceeded | A szervezet elérte a rendszer által kikényszerített költési korlátját. | Emeld meg vagy távolítsd el a korlátot, vagy várd meg a havi keret megújulását. |
| project_spend_limit_exceeded | A projekt elérte a rendszer által kikényszerített költési korlátját. | Emeld meg vagy távolítsd el a projekt korlátját, vagy várd meg a havi keret megújulását. |
Számlázási, költési vagy kvótahiba esetén az újrapróbálkozás nem állítja helyre a hozzáférést. Először a jelzett egyenleggel vagy korláttal kapcsolatos problémát oldd meg. A rendszer által kikényszerített költési korlátok módosításainak érvénybe lépése időbe telhet.
A költési korlát módosításához jogosultság szükséges az érintett szervezet vagy projekt beállításainak kezelésére. Ha nincs hozzáférésed, kérj segítséget attól, aki ezeket a beállításokat kezeli.
Az előre fizetett kreditek vásárlásáról itt olvashatsz: Az előre fizetett API-számlázás beállítása és kezelése.
A különböző költésszabályozási lehetőségekről az API költési korlátairól szóló útmutatóban olvashatsz.
Ellenőrizd a vonatkozó használati korlátokat
Nyisd meg a szervezeted Korlátok oldalát az aktuális használati szint és korlátok áttekintéséhez.
A használati korlátok szervezeti és projektszinten is érvényesek lehetnek. Nem az egyes felhasználók külön keretei. A korlátok modellenként is eltérnek, és egyes modellcsaládokra közös korlát vonatkozik.
Ellenőrizd, melyik korlátot jelzi a hiba. Például a percenkénti kérésszámra és tokenszámra külön korlát vonatkozik. Az egyiket elérheted úgy is, hogy a másik alatt maradsz.
Ellenőrizd a képgenerálási API korlátait
A képgenerálási API használati korlátai a modelltől és a használati szintedtől függenek. A korlátok megtekintéséhez válaszd ki a modelledet a modellek oldalán.
A beállítási lépéseket a képgenerálás fejlesztői útmutatójában találod. A használati szintekről az API használati korlátairól szóló útmutatóban olvashatsz bővebben.
Ellenőrizd, melyik szervezethez tartozik a kérésed
Ha több szervezethez is tartozol, ellenőrizd, hogy a kéréseid a kívánt szervezetet és projektet használják-e.
Ha az API-kulcsod alapértelmezett szervezetet használ, ellenőrizd az alapértelmezett szervezet beállítását. Az egyes szervezetek számlázási feltételei és használati szintjei eltérhetnek.
Csökkentsd az átmeneti használati korlát miatti hibák számát
Ütemezd egyenletesen a kéréseket, és kerüld a hirtelen terhelési csúcsokat
Oszd el időben a kéréseket ahelyett, hogy egyszerre sokat küldenél.
A használati korlátokat a rendszer a megjelenített időszaknál rövidebb időszakokra is érvényesítheti. Például a percenként 60 kéréses korlátot 1 másodperces időszakokra is érvényesítheti. Ezért egy rövid terhelési csúcs akkor is hibát válthat ki, ha az átlagos használatod látszólag a percenkénti korlát alatt marad.
A hosszú utasítások és a szükségtelenül nagy kimeneti tokenkeretek szintén hozzájárulhatnak a tokenek használati korlátjának túllépéséhez.
Várj az újrapróbálkozás előtt
Átmeneti használati korlát miatti hibák esetén:
Ellenőrizd, hogy a válasz tartalmaz-e Retry-After fejlécet.
Ha a fejléc érvényes várakozási időt ad meg, legalább ennyi ideig várj az újrapróbálkozás előtt.
Ha a fejléc hiányzik vagy érvénytelen, használj véletlenszerű eltéréssel kiegészített exponenciális visszalépést: minden sikertelen kísérlet után növeld a várakozási időt, és adj hozzá egy kis véletlenszerű késleltetést.
Korlátozd az újrapróbálkozások számát és az újrapróbálkozásra fordított teljes időt is.
A hivatalos OpenAI SDK-k már eleve újrapróbálkoznak az erre alkalmas, használati korlát miatti hibák esetén, és figyelembe veszik a Retry-After fejlécet, ha van ilyen. Vedd figyelembe ezeket az újrapróbálkozásokat, mielőtt újabb újrapróbálkozási ciklust adsz hozzá.
A sikertelen kérések is beleszámítanak a percenkénti korlátokba. Ugyanannak a kérésnek a folyamatos újraküldése elhúzódóvá teheti a problémát.
Megvalósítási útmutatást és példákat az API használati korlátairól szóló útmutatóban találsz. Mielőtt külső fejlesztőtől származó, újrapróbálkozást kezelő könyvtárat használsz az alkalmazásodban, vizsgáld meg a működését.
Vizsgáld felül az utasítás és a kimenet méretét
Távolítsd el az utasításaidból a szükségtelen előírásokat, az ismétlődő háttérinformációkat és a példákat. Teszteld a módosított utasítást, hogy továbbra is a szükséges eredményt adja-e.
Használd a végpontod és modelled által támogatott, kimeneti tokenszámot szabályozó paramétert:
A Chat Completions a max_completion_tokens paramétert használja.
A Responses a max_output_tokens paramétert használja.
Ne állíts be a kéréshez szükségesnél jóval nagyobb keretet. Ezek a paraméterek az érvelési tokeneket és a látható kimenetet egyaránt magukban foglalják, ezért érvelési modell használatakor mindkettővel számolj.
Ellenőrizd a használati szintedet
Ha a terhelési csúcsok csökkentése és a tokenhasználat áttekintése után is jelentkeznek hibák, nézd meg a Korlátok oldalon, milyen lehetőségeid vannak a korlátok emelésére.
A szervezeted automatikusan magasabb fizetős használati szintre lép, amint az összes kreditvásárlása eléri a Build, Launch és Grow szintek küszöbértékét. A magasabb szintek általában magasabb használati korlátokat biztosítanak. A szintek követelményeit az API használati korlátairól szóló útmutatóban találod.
A jóváhagyott havi használati korlátod független a kérésekre és tokenekre vonatkozó használati korlátoktól. Az egyik emeléséből nem következik, hogy a másik is megváltozott.
Ha a probléma továbbra is fennáll
Mielőtt segítséget kérsz
Készítsd elő a pontos hibaüzenetet, az esetleges hibakódot, az érintett kérések azonosítóit, a hiba időpontját az időzónával együtt, valamint a fiókodban megjelenő érintett korlátot. Jegyezd fel a már kipróbált lépéseket.
Lépj kapcsolatba az OpenAI ügyfélszolgálatával
Ha a jelzett korlát ellenőrzése után sem tudod megoldani a problémát, lépj kapcsolatba az OpenAI ügyfélszolgálatával a Súgóközponton keresztül. Ne adj meg API-kulcsokat vagy más titkos hitelesítési adatokat.