Erori

HTTP	Sens	Acțiune recomandată
400	Solicitare nevalidă	JSON corect și câmpurile obligatorii
401	Cheie nevalidă, blocată sau revocată	Rotiți sau deblocați cheia
402	Sold insuficient al contului sau limita de utilizare a cheii atinsă	Adăugați fonduri sau resetați/măriți limita cheii
403	Model indisponibil pentru cheia sau IP-ul sursă respins de o listă de permisiuni API	Actualizați permisiunile cheii sau utilizați un IP sursă permis
404	Solicitare finală, model sau asincronă necunoscută	Verificați identificatorul și calea
413	Solicitare prea mare	Reduceți dimensiunea contextului
429	RPM sau concurența a fost depășită	Onora Retry-After
500	Eroare de gateway	Reîncercați și inspectați jurnalele
502/503/504	În amonte indisponibil sau expirat	Reîncercați cu backoff exponențial

Este necesară plata

Soldul insuficient al companiei/contului returnează HTTP 402 Payment Required în plicul compatibil cu OpenAI:

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

Același motiv/cod stabil este înregistrat în Istoricul cererilor. O 402 cererea este respinsă înainte de executarea furnizorului și nu ar trebui să fie reîncercată automat până când finanțarea sau constrângerea de cheltuieli aplicabilă nu a fost corectată.

Respingerea listei permise IP

Când o cheie API autentificată este validă, dar adresa sursă se află în afara listei de permisiuni efective pentru API-ul personal sau al organizației de afaceri, Model Gate respinge cererea înainte de executarea în amonte. Răspunsurile compatibile cu OpenAI folosesc HTTP 403 cu cod ip_not_allowed. Răspunsurile compatibile cu antropice folosesc plicul de eroare antropică cu HTTP 403 şi authentication_error. Nu reîncercați din aceeași sursă interzisă; modificați lista de permis configurată sau trimiteți cererea de la o adresă permisă.

Reîncercați 429 după Retry-After. Reîncercați 500, 502, 503, și 504 de până la trei ori cu retragere de 1/2/4 secundă. Nu reîncercați automat validarea, autentificarea, soldul sau erorile negăsite.

Utilizați ID-ul public solicitat de la X-Request-ID pentru a corela răspunsul cu jurnalul cererilor.