Vead

HTTP veakoodid, vastuse vormingud ja uuesti proovimise reeglid.

HTTP	Tähendus	Soovitatav tegevus
400	Kehtetu taotlus	Parandage JSON ja kohustuslikud väljad
401	Kehtetu, külmutatud või tühistatud võti	Pöörake või vabastage võti
402	Konto ebapiisav saldo või võtmekasutuse limiit on täis	Lisage raha või lähtestage/suurendage võtmelimiiti
403	API lubamisloendi poolt tagasi lükatud võtme või allika IP mudel pole saadaval	Värskendage võtmeõigusi või kasutage lubatud allika IP-d
404	Tundmatu lõpp-punkt, mudel või asünkroonimistaotlus	Kontrollige identifikaatorit ja teed
413	Taotlus on liiga suur	Vähendage konteksti suurust
429	RPM või samaaegsus on ületatud	Au `Retry-After`
500	Lüüsi viga	Proovige uuesti ja kontrollige logisid
502/503/504	Ülesvoolu pole saadaval või aegus	Proovige uuesti eksponentsiaalse tagasilöögiga

Nõutav makse

Ettevõtte/konto ebapiisav saldo tagastab HTTP 402 Payment Required OpenAI-ga ühilduvas ümbrikus:

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

Sama stabiilne põhjus/kood salvestatakse taotluste ajaloos. A 402 taotlus lükatakse tagasi enne teenusepakkuja täitmist ja seda ei tohiks automaatselt uuesti proovida enne, kui rahastamine või kohaldatav kulupiirang on parandatud.

IP lubamisloendi tagasilükkamine

Kui autentitud API võti on kehtiv, kuid lähteaadress on väljaspool kehtivat isikliku või äriorganisatsiooni API lubatud loendit, lükkab Model Gate taotluse enne ülesvoolu täitmist tagasi. OpenAI-ga ühilduvad vastused kasutavad HTTP-d 403 koodiga ip_not_allowed. Anthropic-ühilduvad vastused kasutavad HTTP-ga Anthropic errori ümbrikut 403 ja authentication_error. Ärge proovige uuesti samast keelatud allikast; muutke seadistatud lubade loendit või saatke päring lubatud aadressilt.

Proovi uuesti 429 pärast Retry-After. Proovi uuesti 500, 502, 503ja 504 kuni kolm korda 1/2/4-sekundilise tagasilöögiga. Ärge proovige automaatselt uuesti valideerimist, autentimist, tasakaalu või leidmata vigu.

Kasutage päringu avalikku ID-d X-Request-ID vastuse korreleerimiseks taotluste logi.

Vead pärast voopäiseid

SSE võib ebaõnnestuda pärast seda, kui HTTP200 on juba saadetud. Seejärel sisaldab vastus protokolliga ühilduvat veasündmust; lüüsi päringute ajalugu salvestab terminali rikke sõltumata juhtme olekust. Tundmatud ülesvoolu sõnumid on vaikimisi peidetud, heakskiidetud sõnumid võivad avalikustada administraatoripoliitikaga ja täielik ülesvoolu veateade on selgesõnaline. Sisemised ülesvoolu metaandmed ja ajutised töötlemata andmed jäävad ainult administraatorile. Puuduv kasutus pärast katkenud voogu on teadmata/nõutav ülevaatamine, mitte automaatne hinnang juhtmebaitidest. Säilitage päringu ID ja proovige uuesti alles pärast osalise väljundi kontrollimist.