Feil

HTTP-feilkoder, svarformater og regler for forsøk på nytt.

HTTP	Betydning	Anbefalt handling
400	Ugyldig forespørsel	Korriger JSON og obligatoriske felt
401	Ugyldig, frosset eller tilbakekalt nøkkel	Roter eller frigjør nøkkelen
402	Utilstrekkelig kontosaldo eller grense for nøkkelbruk er nådd	Legg til midler eller tilbakestill/øk nøkkelgrensen
403	Modellen er utilgjengelig for nøkkelen eller kilde-IP-en som er avvist av en API-godkjenningsliste	Oppdater nøkkeltillatelser eller bruk en tillatt kilde-IP
404	Ukjent endepunkt, modell eller asynkronforespørsel	Sjekk identifikatoren og banen
413	Forespørselen er for stor	Reduser kontekststørrelsen
429	RPM eller samtidighet overskredet	Ære `Retry-After`
500	Gateway-feil	Prøv på nytt og inspiser logger
502/503/504	Oppstrøms utilgjengelig eller tidsavbrutt	Prøv på nytt med eksponentiell backoff

Betaling kreves

Utilstrekkelig selskap/kontosaldo returnerer HTTP 402 Payment Required i den OpenAI-kompatible konvolutten:

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

Den samme stabile årsaken/koden er registrert i Forespørselshistorikk. EN 402 Forespørselen avvises før leverandøren utføres og bør ikke prøves automatisk på nytt før finansiering eller gjeldende utgiftsbegrensning er korrigert.

Avvisning av IP-godkjenningsliste

Når en autentisert API-nøkkel er gyldig, men kildeadressen er utenfor den effektive personlige eller forretningsorganisasjons API-godkjenningslisten, avviser Model Gate forespørselen før oppstrøms utførelse. OpenAI-kompatible svar bruker HTTP 403 med kode ip_not_allowed. Antropisk-kompatible svar bruker Antropisk feilkonvolutt med HTTP 403 og authentication_error. Ikke prøv på nytt fra den samme ikke-tillatte kilden; endre den konfigurerte godkjenningslisten eller send forespørselen fra en tillatt adresse.

Prøv på nytt 429 etter Retry-After. Prøv på nytt 500, 502, 503, og 504 opptil tre ganger med 1/2/4-sekunds backoff. Ikke prøv automatisk validering, autentisering, balanse eller feil som ikke ble funnet.

Bruk forespørselen offentlig ID fra X-Request-ID å korrelere responsen med forespørselslogg.

Feil etter strømoverskrifter

SSE kan mislykkes etter at HTTP200 allerede er sendt. Svaret inneholder da en protokollkompatibel feilhendelse; gateway-forespørselshistorikken registrerer terminalfeilen uavhengig av ledningsstatusen. Ukjente oppstrømsmeldinger er skjult som standard, godkjente meldinger kan avsløres av administratorens retningslinjer, og full oppstrømsfeileksponering er eksplisitt. Interne oppstrøms metadata og midlertidige rådata forblir kun for administratorer. Manglende bruk etter en avbrutt strøm er ukjent/krevd gjennomgang, ikke et automatisk estimat fra ledningsbyte. Behold forespørsels-ID-en og prøv på nytt bare bevisst etter å ha kontrollert delvis utdata.