Pārskats
Uz API lietojumu attiecas darbības ierobežojumi. Šie ierobežojumi nosaka pieprasījumu, tekstvienību vai cita lietojuma apjomu noteiktā laikposmā.
Atbilde 429 var norādīt uz īslaicīgu darbības ierobežojumu, iztērētu priekšapmaksas atlikumu vai tēriņu vai lietojuma ierobežojumu. Pirms mēģināt vēlreiz vai mainīt norēķinu iestatījumus, pārbaudiet kļūdas informāciju.
Nosakiet cēloni
Izlasiet kļūdas ziņojumu un, ja norādīts, error.code. Ar norēķiniem saistītām kļūdām joprojām var būt vispārīgākā error.type vērtība insufficient_quota.
| Kļūda vai kods | Ko tas nozīmē | Kā rīkoties |
| Sasniegts pieprasījumu vai tekstvienību darbības ierobežojums | Pieprasījumi pārsniedz piemērojamo darbības ierobežojumu. | Izlīdziniet pieprasījumu plūsmu un ievērojiet tālāk sniegtos norādījumus par atkārtotiem mēģinājumiem. |
| credit_balance_exhausted | Organizācijai nav atlikuši priekšapmaksas kredīti. | Pievienojiet kredītus API norēķinu iestatījumos. |
| organization_usage_limit_exceeded | Organizācija ir sasniegusi OpenAI piešķirto lietojuma ierobežojumu. | Pieprasiet lielāku apstiprināto lietojuma ierobežojumu. |
| organization_spend_limit_exceeded | Organizācija ir sasniegusi noteikto tēriņu ierobežojumu. | Palieliniet vai noņemiet ierobežojumu vai gaidiet tā atiestatīšanu nākamajā mēnesī. |
| project_spend_limit_exceeded | Projekts ir sasniedzis noteikto tēriņu ierobežojumu. | Palieliniet vai noņemiet projekta ierobežojumu vai gaidiet tā atiestatīšanu nākamajā mēnesī. |
Atkārtots mēģinājums neatjauno piekļuvi, ja kļūda ir saistīta ar norēķiniem, tēriņiem vai kvotu. Vispirms novērsiet norādīto atlikuma vai ierobežojuma problēmu. Var paiet laiks, līdz stājas spēkā noteikto tēriņu ierobežojumu izmaiņas.
Lai mainītu tēriņu ierobežojumu, nepieciešama atļauja pārvaldīt attiecīgās organizācijas vai projekta iestatījumus. Ja jums nav piekļuves, lūdziet palīdzību personai, kura pārvalda šos iestatījumus.
Informāciju par priekšapmaksas kredītu iegādi skatiet rakstā API priekšapmaksas norēķinu iestatīšana un pārvaldība.
Informāciju par dažādajiem tēriņu kontroles līdzekļiem skatiet API tēriņu ierobežojumu ceļvedī.
Pārbaudiet piemērojamos darbības ierobežojumus
Atveriet savas organizācijas lapu Ierobežojumi, lai pārskatītu pašreizējo lietojuma līmeni un ierobežojumus.
Darbības ierobežojumus var piemērot organizācijas un projekta līmenī. Tās nav atsevišķu lietotāju kvotas. Ierobežojumi atšķiras arī pēc modeļa, un dažām modeļu saimēm ir kopīgs ierobežojums.
Pārbaudiet, kurš ierobežojums ir norādīts kļūdā. Piemēram, pieprasījumiem minūtē un tekstvienībām minūtē ir atsevišķi ierobežojumi. Varat sasniegt vienu ierobežojumu, nepārsniedzot otru.
Pārbaudiet, kuru organizāciju izmanto pieprasījums
Ja esat vairāku organizāciju dalībnieks, pārbaudiet, vai pieprasījumos tiek izmantota paredzētā organizācija un projekts.
Ja jūsu API atslēga izmanto noklusējuma organizāciju, pārbaudiet noklusējuma organizācijas iestatījumu. Dažādām organizācijām var būt atšķirīgi norēķinu nosacījumi un lietojuma līmeņi.
Samaziniet īslaicīgas darbības ierobežojuma kļūdas
Izlīdziniet pieprasījumu plūsmu un izvairieties no uzplūdiem
Sadaliet pieprasījumus laikā, nevis sūtiet daudzus vienlaikus.
Darbības ierobežojumus var piemērot īsākos laikposmos nekā norādītais intervāls. Piemēram, ierobežojumu 60 pieprasījumi minūtē var piemērot arī vienas sekundes laikposmiem. Tāpēc īss pieprasījumu uzplūds var izraisīt kļūdu, pat ja vidējais lietojums šķiet mazāks par minūtes ierobežojumu.
Tekstvienību apjoma kļūdas var izraisīt arī garas uzvednes un nevajadzīgi lielas izvades tekstvienību kvotas.
Mēģiniet vēlreiz pēc aizkaves
Īslaicīgu darbības ierobežojuma kļūdu gadījumā:
Pārbaudiet, vai atbildē ir galvene Retry-After.
Ja galvenē ir norādīta derīga aizkave, pirms nākamā mēģinājuma nogaidiet vismaz tik ilgi.
Ja galvenes nav vai tā nav derīga, izmantojiet eksponenciālu aizkaves palielināšanu ar nejaušu novirzi: pēc katra neveiksmīga mēģinājuma palieliniet aizkavi un pievienojiet nelielu nejaušu aizkavi.
Ierobežojiet gan atkārtoto mēģinājumu skaitu, gan tiem kopumā atvēlēto laiku.
Oficiālie OpenAI SDK jau atkārtoti izpilda darbības ierobežojuma kļūdu dēļ neizdevušos pieprasījumus un ievēro Retry-After, ja šī galvene ir norādīta. Pirms pievienojat vēl vienu atkārtošanas ciklu, ņemiet vērā šos mēģinājumus.
Neveiksmīgi pieprasījumi tiek ieskaitīti minūtes ierobežojumos. Nepārtraukta viena un tā paša pieprasījuma sūtīšana var paildzināt problēmu.
Ieviešanas norādījumus un piemērus skatiet API darbības ierobežojumu ceļvedī. Pirms savā lietojumprogrammā izmantojat trešās puses atkārtotu mēģinājumu bibliotēku, pārskatiet to.
Pārskatiet uzvednes un izvades apjomu
No uzvednēm izņemiet nevajadzīgas instrukcijas, atkārtotu kontekstu un piemērus. Pārbaudiet pārskatīto uzvedni, lai pārliecinātos, ka tā joprojām nodrošina vajadzīgo rezultātu.
Izmantojiet galapunkta un modeļa atbalstīto izvades tekstvienību parametru:
Chat Completions izmanto max_completion_tokens.
Responses izmanto max_output_tokens.
Neiestatiet daudz lielāku kvotu, nekā nepieciešams pieprasījumam. Šajos parametros tiek ieskaitītas gan spriestspējas tekstvienības, gan redzamā izvade, tāpēc, izmantojot spriestspējas modeli, paredziet vietu abām.
Pārskatiet savu lietojuma līmeni
Ja kļūdas turpinās pēc pieprasījumu uzplūdu mazināšanas un tekstvienību lietojuma pārskatīšanas, savā lapā Ierobežojumi skatiet pieejamās iespējas palielināt ierobežojumus.
Pieaugot API tēriņiem, OpenAI var automātiski pārcelt organizāciju uz augstāku lietojuma līmeni. Parasti tas palielina darbības ierobežojumus lielākajai daļai modeļu.
Apstiprinātais mēneša lietojuma ierobežojums nav saistīts ar pieprasījumu un tekstvienību darbības ierobežojumiem. Viena palielināšana nenozīmē, ka ir mainījies arī otrs.
Ja problēma joprojām pastāv
Pirms problēmas eskalācijas
Sagatavojiet precīzu kļūdas ziņojumu, kļūdas kodu, ja tāds ir, attiecīgos pieprasījumu ID, kļūdas laiku un savu laika joslu, kā arī kontā redzamo attiecīgo ierobežojumu. Pierakstiet jau izmēģinātās darbības.
Sazinieties ar OpenAI atbalsta dienestu
Ja pēc norādītā ierobežojuma pārbaudes nevarat atrisināt problēmu, sazinieties ar OpenAI atbalsta dienestu, izmantojot Palīdzības centru. Nenorādiet API atslēgas vai citus autentifikācijas noslēpumus.