Developer guide

Fejlkoder

Håndtering og regler for genforsøg efter statuskode

Denne side opsummerer statuskoderne, som gatewayen returnerer, deres betydning og håndteringen af hver kode.
Hvis upstream returnerer en 4xx- eller 5xx-kode, videresendes koden uændret; i alle andre tilfælde gælder tabellen nedenfor.
Vi beskriver også formatet for fejlteksten i de to kompatibilitetsstandarder, reglerne for Anthropic-kompatibel error.type samt konsolskærmen til kontrol af grænser og forbrug.

Statuskode

Kode	Betydning	Håndtering
400	Fejl i anmodningsværdien. limit for Anthropic-kompatible modelliste ligger uden for 1~1000, eller der er forsøgt at fortsætte en gemt respons med GET /responses/{responseId}?stream=true	Ret værdien til at ligge inden for området. Hent gemte responser uden stream.
401	Nøgle mangler eller er udløbet eller tilbagekaldt	Kontrollér nøglens status på API-nøglesiden, og kontrollér headernavnet og Bearer-præfikset.
403	Ingen adgang til modellen, brugsgrænsen er overskredet, utilstrækkelige kreditter eller du er ikke ejeren af stemmen	error.message angiver årsagen. Du kan se tallene på skærmen i afsnittet nedenfor om kontrol af grænser og forbrug.
404	Modellen findes ikke eller kan ikke tilgås med denne nøgle (herunder modeller, hvis support er ophørt), stien findes ikke, eller CleviDrive-outputtet er ældre end opbevaringsperioden på 3 dage	Kontrollér først listen over modeller, der kan kaldes, med GET /models. Sammenhold stien med tabellen på siden Sådan kalder du API'et.
408 · 409 · 413	Timeout hos upstream, overbelastning eller anmodningen er for stor. Tidsgrænsen for tale- og stemmesti er 5 minutter, og grænsen for anmodninger er 28 MiB	Hvis 409 har Retry-After, skal du vente det angivne tidsrum. Del anmodningen op ved 413.
429	Når upstream-udbyderen har indført en hastighedsbegrænsning	Følg Retry-After, hvis den findes; ellers prøv igen med eksponentiel backoff.
5xx	Midlertidig fejl i gatewayen eller upstream (inklusive 503)	Prøv igen med eksponentiel backoff. Hvis det gentager sig, skal du give os besked via Hjælp og Kontakt sammen med X-Request-Id.

Genforsøg

Gatewayen opretter ikke selv 429 og genforsøger eller kølægger heller ikke upstream-svar uden at gøre opmærksom på det.
Klienten håndterer ventetid og genforsøg.

Kode	Ventetid	Derefter
409	Hvis Retry-After findes, den angivne tid	Sender den samme anmodning igen.
429	Hvis Retry-After findes, den angivne tid; ellers eksponentiel backoff	Sender den samme anmodning igen.
5xx	Eksponentiel backoff	Kontakter support, hvis det gentager sig.
413	Ingen ventetid	Deler anmodningen op.

Fejltekst

Fejlteksten har forskellig struktur afhængigt af specifikationen. Upstream-fejl videresendes i en opryddet form med kun meddelelsen; stacktraces og interne felter videresendes ikke.

Dette er teksten for den OpenAI-kompatible sti.

JSON

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

Dette er teksten for den Anthropic-kompatible sti. error.type bestemmes ud fra statuskoden.

JSON

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}

Anthropic-kompatibel error.type

Statuskode	error.type
400	invalid_request_error
401	authentication_error
403	permission_error
404	not_found_error
413	request_too_large
429	rate_limit_error
529	overloaded_error
Andre koder	api_error

Kontrol af grænser og forbrug

Grænseværdierne varierer fra workspace til workspace. Kontrollér årsagen til 403 i error.message, og se derefter værdierne på skærmene nedenfor.

Det, der skal kontrolleres	Konsolskærm
Grænse for mit workspace	Tildelt forbrugsgrænse under Oversigt
Område og saldo, som planen tillader	Plan og kreditter
Det faktiske forbrug (kald pr. model og nøgle, forventede fratrukne kreditter)	Forbrug
Nøglens status (om den er udløbet eller tilbagekaldt)	API-nøgle

Fejlkoder

Statuskode

Genforsøg

Fejltekst

Kontrol af grænser og forbrug

Sprog og region

Anbefales

Østasien

Sydøstasien

Sydasien

Centralasien

Mellemøsten og Kaukasus

Vesteuropa og Sydeuropa

Storbritannien og Irland

Nordeuropa

Centraleuropa og Balkan

Østeuropa

Østafrika

Vestafrika og Centralafrika

Det sydlige Afrika

Nord-, Mellem- og Sydamerika

Oceanien