Kļūdas
HTTP kļūdu kodi, atbildes formāti un atkārtošanas kārtulas.
| HTTP | Nozīme | Ieteicamā darbība |
|---|---|---|
| 400 | Nederīgs pieprasījums | Labojiet JSON un obligātos laukus |
| 401 | Nederīga, iesaldēta vai atsaukta atslēga | Pagrieziet vai atsaldējiet atslēgu |
| 402 | Sasniegts nepietiekams konta atlikums vai atslēgas izmantošanas ierobežojums | Pievienojiet līdzekļus vai atiestatiet/palieliniet atslēgu ierobežojumu |
| 403 | Modelis nav pieejams atslēgai vai avota IP, ko noraidīja API atļauju saraksts | Atjauniniet atslēgas atļaujas vai izmantojiet atļautu avota IP |
| 404 | Nezināms galapunkts, modelis vai asinhronais pieprasījums | Pārbaudiet identifikatoru un ceļu |
| 413 | Pieprasījums ir pārāk liels | Samaziniet konteksta lielumu |
| 429 | Pārsniegts IPT vai vienlaicība | Gods Retry-After |
| 500 | Vārtejas kļūda | Mēģiniet vēlreiz un pārbaudiet žurnālus |
| 502/503/504 | Augšupstraume nav pieejama vai iestājies noildze | Mēģiniet vēlreiz ar eksponenciālu atkāpšanos |
Nepieciešams maksājums
Nepietiekams uzņēmuma/konta atlikums atgriež HTTP 402 Payment Required ar OpenAI saderīgā aploksnē:
{
"error": {
"message": "Insufficient account balance.",
"type": "payment_required",
"code": "insufficient_balance"
}
}
Tas pats stabilais iemesls/kods tiek ierakstīts pieprasījumu vēsturē. A 402 pieprasījums tiek noraidīts pirms pakalpojumu sniedzēja izpildes, un to nevajadzētu automātiski mēģināt atkārtoti, kamēr nav izlabots finansējums vai piemērojamais izdevumu ierobežojums.
IP atļaušanas saraksta noraidīšana
Ja autentificēta API atslēga ir derīga, bet avota adrese ir ārpus faktiskā personiskā vai biznesa organizācijas API atļauju saraksta, Model Gate noraida pieprasījumu pirms augšupējas izpildes. Ar OpenAI saderīgās atbildes izmanto HTTP 403 ar kodu ip_not_allowed. Ar antropu saderīgām atbildēm tiek izmantota antropiskās kļūdas aploksne ar HTTP 403 un authentication_error. Nemēģiniet vēlreiz no tā paša neatļautā avota; mainiet konfigurēto atļauto sarakstu vai nosūtiet pieprasījumu no atļautas adreses.
Mēģiniet vēlreiz 429 pēc Retry-After. Mēģiniet vēlreiz 500, 502, 503, un 504 līdz trīs reizēm ar 1/2/4 sekundes atkāpšanos. Nemēģiniet automātiski atkārtoti apstiprināt, autentifikāciju, līdzsvaru vai kļūdas, kas nav atrastas.
Izmantojiet pieprasījumu publisko ID no X-Request-ID lai saistītu atbildi ar pieprasījumu žurnāls.
Kļūdas pēc straumes galvenēm
SSE var neizdoties pēc tam, kad HTTP200 jau ir nosūtīts. Pēc tam atbilde satur ar protokolu saderīgu kļūdas notikumu; vārtejas pieprasījumu vēsture reģistrē termināļa kļūmi neatkarīgi no vada statusa. Nezināmi augšupējie ziņojumi pēc noklusējuma ir paslēpti, apstiprinātie ziņojumi var tikt atklāti saskaņā ar administratora politiku, un ir nepārprotami atklāta pilnīga augšējo kļūdu atklāšana. Iekšējie augšējie metadati un pagaidu neapstrādātie dati paliek tikai administratoram. Trūkstošais lietojums pēc pārtrauktas straumes nav zināms/ir nepieciešama pārskatīšana, nevis automātisks aprēķins no vada baitiem. Saglabājiet pieprasījuma ID un mēģiniet vēlreiz tikai pēc daļējas izvades pārbaudes.