Fejl

HTTP	Mening	Anbefalet handling
400	Ugyldig anmodning	Ret JSON og obligatoriske felter
401	Ugyldig, frosset eller tilbagekaldt nøgle	Drej eller frigør nøglen
402	Utilstrækkelig kontosaldo eller grænse for nøgleforbrug er nået	Tilføj midler eller nulstil/forøg nøglegrænsen
403	Modellen er ikke tilgængelig for nøglen eller kilde-IP, der er afvist af en API-tilladelsesliste	Opdater nøgletilladelser, eller brug en tilladt kilde-IP
404	Ukendt slutpunkt, model eller async-anmodning	Tjek identifikatoren og stien
413	Anmodningen er for stor	Reducer kontekststørrelsen
429	RPM eller samtidighed overskredet	Ære Retry-After
500	Gateway fejl	Prøv igen og inspicér logfiler
502/503/504	Upstream utilgængelig eller timeout	Prøv igen med eksponentiel backoff

Betaling påkrævet

Utilstrækkelig virksomhed/kontosaldo returnerer HTTP 402 Payment Required i den OpenAI-kompatible konvolut:

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

Den samme stabile årsag/kode er registreret i Request History. EN 402 anmodningen afvises før udbyderens udførelse og bør ikke automatisk prøves igen, før finansieringen eller den gældende udgiftsbegrænsning er blevet rettet.

Afvisning af IP-tilladelsesliste

Når en autentificeret API-nøgle er gyldig, men kildeadressen er uden for den effektive personlige eller forretningsorganisations API-tilladelsesliste, afviser Model Gate anmodningen før opstrøms eksekvering. OpenAI-kompatible svar bruger HTTP 403 med kode ip_not_allowed. Antropisk-kompatible svar bruger den antropiske fejlkonvolut med HTTP 403 og authentication_error. Forsøg ikke igen fra den samme ikke-tilladte kilde; ændre den konfigurerede tilladelsesliste eller send anmodningen fra en tilladt adresse.

Prøv igen 429 efter Retry-After. Prøv igen 500, 502, 503, og 504 op til tre gange med 1/2/4-sekund backoff. Forsøg ikke automatisk validering, godkendelse, balance eller ikke-fundne fejl igen.

Brug anmodningens offentlige ID fra X-Request-ID at korrelere svaret med anmodningslog.