Napake

Kode napak HTTP, oblike odgovorov in pravila za ponovni poskus.

HTTP	Pomen	Priporočeno dejanje
400	Neveljavna zahteva	Pravilen JSON in zahtevana polja
401	Neveljaven, zamrznjen ali preklican ključ	Obrnite ali odmrznite ključ
402	Nezadostno stanje na računu ali dosežena omejitev uporabe ključa	Dodajte sredstva ali ponastavite/povišajte omejitev ključa
403	Model ni na voljo za ključ ali izvorni IP, ki ga je seznam dovoljenih API zavrnil	Posodobite ključna dovoljenja ali uporabite dovoljen vir IP
404	Neznana končna točka, model ali asinhrona zahteva	Preverite identifikator in pot
413	Zahteva je prevelika	Zmanjšajte velikost konteksta
429	RPM ali sočasnost je presežena	Čast `Retry-After`
500	Napaka prehoda	Poskusite znova in preglejte dnevnike
502/503/504	Navzgor ni na voljo ali je potekla časovna omejitev	Poskusite znova z eksponentnim odmikom

Obvezno plačilo

Nezadostno stanje podjetja/računa vrne HTTP 402 Payment Required v ovojnici, združljivi z OpenAI:

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

Enak stabilen razlog/koda se zabeleži v zgodovini zahtev. A 402 zahteva je zavrnjena pred izvršitvijo ponudnika in je ne bi smeli samodejno znova poskusiti, dokler se financiranje ali veljavna omejitev porabe ne popravi.

Zavrnitev seznama dovoljenih naslovov IP

Ko je ključ API-ja s preverjeno pristnostjo veljaven, vendar je izvorni naslov zunaj dejanskega seznama dovoljenih API-jev za osebne ali poslovne organizacije, Model Gate zavrne zahtevo pred izvedbo navzgor. Odgovori, združljivi z OpenAI, uporabljajo HTTP 403 s kodo ip_not_allowed. Odgovori, združljivi z Anthropic, uporabljajo ovojnico napake Anthropic s HTTP 403 in authentication_error. Ne poskušajte znova iz istega nedovoljenega vira; spremenite konfigurirani dovoljeni seznam ali pošljite zahtevo z dovoljenega naslova.

Poskusite znova 429 po Retry-After. Poskusite znova 500, 502, 503, in 504 do trikrat z 1/2/4-sekundnim odmikom. Ne poskušajte znova samodejno preverjati veljavnosti, preverjanja pristnosti, ravnovesja ali napak, ki niso najdene.

Uporabite javni ID zahteve od X-Request-ID povezati odgovor z dnevnik zahtev.

Napake po glavah tokov

SSE lahko odpove, ko je HTTP200 že poslan. Odgovor nato vsebuje dogodek napake, združljiv s protokolom; zgodovina zahtev prehoda beleži napako terminala neodvisno od statusa žice. Neznana sporočila navzgor so privzeto skrita, odobrena sporočila lahko razkrije pravilnik skrbnika, popolna izpostavljenost napak navzgor pa je izrecna. Notranji metapodatki navzgor in začasna surovina ostajajo samo za skrbnike. Manjkajoča poraba po prekinjenem toku je neznana/potreben je pregled, ne samodejna ocena iz žičnih bajtov. Ohranite ID zahteve in poskusite znova namerno šele po preverjanju delnega izhoda.