Pārskats
Uz API lietošanu attiecas darbības ierobežojumi. Tie ierobežo pieprasījumu skaitu, tekstvienību skaitu vai citu lietojumu noteiktā laika periodā.
Atbilde ar kodu 429 var norādīt uz īslaicīgu darbības ierobežojumu, iztērētu priekšapmaksas atlikumu vai tēriņu vai lietojuma limitu. Pirms atkārtota mēģinājuma vai norēķinu iestatījumu maiņas pārbaudiet kļūdas informāciju.
Noskaidrojiet cēloni
Izlasiet kļūdas ziņojumu un error.code vērtību, ja tā ir norādīta. Arī ar norēķiniem saistītām kļūdā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. | Sūtiet pieprasījumus ar intervāliem un ievērojiet tālāk sniegtos norādījumus par atkārtotiem mēģinājumiem. |
| credit_balance_exhausted | Organizācijai vairs nav priekšapmaksas kredītu. | Papildiniet kredītus API norēķinu iestatījumos. |
| organization_usage_limit_exceeded | Organizācija ir sasniegusi OpenAI noteikto lietojuma limitu. | Pieprasiet apstiprinātā lietojuma limita palielinājumu. |
| organization_spend_limit_exceeded | Organizācija ir sasniegusi tēriņu limitu, kuru nedrīkst pārsniegt. | Palieliniet vai atceliet limitu, vai gaidiet tā atiestatīšanu nākamajā mēnesī. |
| project_spend_limit_exceeded | Projekts ir sasniedzis tēriņu limitu, kuru nedrīkst pārsniegt. | Palieliniet vai atceliet projekta limitu, vai gaidiet tā atiestatīšanu nākamajā mēnesī. |
Atkārtoti mēģinājumi norēķinu, tēriņu vai kvotas kļūdas gadījumā neatjauno piekļuvi. Vispirms novērsiet norādīto problēmu ar atlikumu vai limitu. Var paiet laiks, līdz stājas spēkā izmaiņas tēriņu limitos, kurus nedrīkst pārsniegt.
Lai mainītu tēriņu limitu, ir nepieciešama atļauja pārvaldīt attiecīgās organizācijas vai projekta iestatījumus. Ja jums nav piekļuves, vērsieties pie personas, kura pārvalda šos iestatījumus.
Par priekšapmaksas kredītu iegādi skatiet: API priekšapmaksas norēķinu iestatīšana un pārvaldība.
Informāciju par dažādiem tēriņu kontroles līdzekļiem skatiet API tēriņu limitu ceļvedī.
Pārbaudiet piemērojamos darbības ierobežojumus
Atveriet savas organizācijas limitu lapu, lai pārskatītu tās pašreizējo lietojuma līmeni un limitus.
Darbības ierobežojumus var piemērot organizācijas un projekta līmenī. Tie nav katram lietotājam atsevišķi piešķirti limiti. Limiti atšķiras arī atkarībā no modeļa, un dažām modeļu saimēm ir kopīgs limits.
Pārbaudiet, kurš limits ir norādīts kļūdas ziņojumā. Piemēram, pieprasījumu skaitam minūtē un tekstvienību skaitam minūtē ir atsevišķi limiti. Vienu var sasniegt, kamēr otrs vēl nav sasniegts.
Pārbaudiet attēlu ģenerēšanas API ierobežojumus
Attēlu ģenerēšanas API darbības ierobežojumi ir atkarīgi no modeļa un jūsu lietojuma līmeņa. Modeļu lapā atlasiet savu modeli, lai skatītu tā ierobežojumus.
Iestatīšanas norādījumus skatiet attēlu ģenerēšanas ceļvedī izstrādātājiem. Plašāku informāciju par lietojuma līmeņiem skatiet API darbības ierobežojumu ceļvedī.
Pārliecinieties, kuru organizāciju izmanto jūsu pieprasījums
Ja esat vairāku organizāciju dalībnieks, pārliecinieties, ka jūsu pieprasījumi izmanto paredzēto organizāciju un projektu.
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īgu darbības ierobežojumu kļūdu skaitu
Sūtiet pieprasījumus ar intervāliem un izvairieties no straujiem pieprasījumu skaita kāpumiem
Sadaliet pieprasījumus laika gaitā, nevis sūtiet daudzus vienlaikus.
Darbības ierobežojumus var piemērot īsākiem periodiem nekā norādītais intervāls. Piemēram, 60 pieprasījumu minūtē ierobežojumu var piemērot arī 1 sekundes periodiem. Tāpēc īslaicīgs pieprasījumu skaita kāpums var izraisīt kļūdu pat tad, ja vidējais lietojums šķiet zemāks par minūtes limitu.
Arī garas uzvednes un nevajadzīgi liels atļautais izvades tekstvienību skaits var veicināt tekstvienību darbības ierobežojumu kļūdas.
Pirms atkārtota mēģinājuma uzgaidiet
Īslaicīgu darbības ierobežojumu kļūdu gadījumā:
Pārbaudiet, vai atbildē ir Retry-After galvene.
Ja galvenē ir norādīts derīgs gaidīšanas laiks, pirms atkārtota mēģinājuma uzgaidiet vismaz tik ilgi.
Ja galvenes nav vai tā nav derīga, izmantojiet eksponenciāli pieaugošu gaidīšanas laiku ar nejaušām svārstībām: pēc katra neveiksmīga mēģinājuma palieliniet gaidīšanas laiku un pievienojiet nelielu nejaušu aizkavi.
Ierobežojiet gan atkārtoto mēģinājumu skaitu, gan tiem veltīto kopējo laiku.
Oficiālie OpenAI SDK jau atkārto pieprasījumus tādu darbības ierobežojumu kļūdu gadījumā, kurām tas ir pieļaujams, un ievēro Retry-After galveni, ja tā ir norādīta. Pirms pievienojat vēl vienu atkārtoto mēģinājumu ciklu, ņemiet vērā šos mēģinājumus.
Arī neveiksmīgie pieprasījumi tiek ieskaitīti minūtes limitos. Nepārtraukta viena un tā paša pieprasījuma atkārtota 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ā lietotnē izmantojat trešās puses bibliotēku atkārtotiem mēģinājumiem, izvērtējiet to.
Pārskatiet uzvednes un izvades apjomu
Noņemiet no uzvednēm nevajadzīgus norādījumus, atkārtotu kontekstu un piemērus. Pārbaudiet pārstrādāto uzvedni, lai pārliecinātos, ka tā joprojām sniedz vajadzīgo rezultātu.
Izmantojiet izvades tekstvienību parametru, ko atbalsta jūsu galapunkts un modelis:
Chat Completions izmanto max_completion_tokens.
Responses izmanto max_output_tokens.
Nenorādiet daudz lielāku atļauto skaitu, nekā pieprasījumam nepieciešams. Šie parametri ietver gan spriestspējas tekstvienības, gan redzamo izvadi, tāpēc, izmantojot spriestspējas modeli, paredziet vietu abām.
Pārskatiet savu lietojuma līmeni
Ja kļūdas turpinās arī pēc tam, kad esat samazinājis pieprasījumu skaita straujos kāpumus un pārskatījis tekstvienību lietojumu, skatiet limitu lapā pieejamās iespējas palielināt limitus.
Jūsu organizācijas maksas lietojuma līmenis tiek automātiski paaugstināts, kad kopējā kredītu iegādes summa sasniedz Build, Launch un Grow sliekšņus. Augstāki līmeņi parasti nodrošina lielākus darbības ierobežojumus. Līmeņu prasības skatiet API darbības ierobežojumu ceļvedī.
Jūsu apstiprinātais mēneša lietojuma limits ir atsevišķs no pieprasījumu un tekstvienību darbības ierobežojumiem. Viena limita palielinājums nenozīmē, ka ir mainījies arī otrs.
Ja problēma saglabājas
Pirms vēršanās pēc palīdzības
Sagatavojiet precīzu kļūdas ziņojumu, kļūdas kodu, ja tāds ir, attiecīgo pieprasījumu ID, kļūdas laiku ar laika joslu un attiecīgo limitu, kas norādīts jūsu kontā. Pierakstiet darbības, kuras jau esat izmēģinājis.
Sazinieties ar OpenAI atbalsta dienestu
Ja pēc norādītā limita pārbaudes nevarat atrisināt problēmu, sazinieties ar OpenAI atbalsta dienestu Palīdzības centrā. Neiekļaujiet API atslēgas vai citus slepenus autentifikācijas datus.