Fel

HTTP	Menande	Rekommenderad åtgärd
400	Ogiltig begäran	Korrigera JSON och obligatoriska fält
401	Ogiltig, fryst eller återkallad nyckel	Vrid eller frigör nyckeln
402	Otillräckligt kontosaldo eller gräns för nyckelanvändning har uppnåtts	Lägg till pengar eller återställ/öka nyckelgränsen
403	Modellen är inte tillgänglig för nyckeln eller käll-IP som avvisats av en API-godkännandelista	Uppdatera nyckelbehörigheter eller använd en tillåten käll-IP
404	Okänd slutpunkt, modell eller asynkronbegäran	Kontrollera identifieraren och sökvägen
413	Förfrågan är för stor	Minska kontextstorleken
429	RPM eller samtidighet har överskridits	Ära Retry-After
500	Gateway-fel	Försök igen och inspektera loggar
502/503/504	Upstream otillgänglig eller timeout	Försök igen med exponentiell backoff

Betalning krävs

Otillräckligt företag/kontosaldo returnerar HTTP 402 Payment Required i det OpenAI-kompatibla kuvertet:

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

Samma stabila orsak/kod registreras i Request History. A 402 begäran avvisas innan leverantören verkställs och bör inte prövas automatiskt igen förrän finansieringen eller tillämplig utgiftsbegränsning har korrigerats.

Avslag på IP-godkännandelista

När en autentiserad API-nyckel är giltig men källadressen är utanför den effektiva personliga eller affärsorganisations API-tillåtelselista, avvisar Model Gate begäran innan exekvering uppströms. OpenAI-kompatibla svar använder HTTP 403 med kod ip_not_allowed. Antropiska-kompatibla svar använder det antropiska felenveloppet med HTTP 403 och authentication_error. Försök inte igen från samma otillåtna källa; ändra den konfigurerade godkännandelistan eller skicka begäran från en tillåten adress.

Försöka igen 429 efter Retry-After. Försöka igen 500, 502, 503, och 504 upp till tre gånger med 1/2/4-sekund backoff. Försök inte automatiskt igen validering, autentisering, saldo eller ej hittade fel.

Använd begäran offentligt ID från X-Request-ID för att korrelera svaret med förfrågningslogg.