Fel

HTTP-felkoder, svarsformat och regler för försök igen.

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.

Fel efter strömningsrubriker

SSE kan misslyckas efter att HTTP200 redan har skickats. Svaret innehåller sedan en protokollkompatibel felhändelse; gatewayförfrågningshistoriken registrerar terminalfelet oberoende av trådstatusen. Okända uppströmsmeddelanden är dolda som standard, godkända meddelanden kan exponeras av administratörspolicyn och fullständig exponering för uppströmsfel är explicit. Intern uppströms metadata och tillfälliga rådata förblir endast administratörer. Saknad användning efter en avbruten stream är okänd/recensionskrävd, inte en automatisk uppskattning från trådbytes. Bevara begäran-ID:t och försök igen endast medvetet efter att ha kontrollerat partiell utdata.