Virgoen a Reegel fir d’Neiausféierung no Statuscoden
Dës Säit faasst d’Statuscoden zesummen, déi vum Gateway zeréckginn, hir Bedeitung an d’Virgoe pro Code. Wann den Upstream e 4xx·5xx zeréckgëtt, gëtt dee Code onverännert weidergeleet. An allen anere Fäll gëllt d’Tabell hei drënner. Mir hunn och d’Format vum Feelerkierper vun den zwou kompatiblen Spezifikatiounen, d’Reegele fir Anthropic-kompatibel error.type an d’Konsolbildschiermer zur Kontroll vun de Limiten an der Notzung dokumentéiert.
Statuscode
Code
Bedeitung
Virgoen
400
Feeler an de Ufroewäerter. Bei der Lëscht vun den Anthropic-kompatibele Modeller läit limit ausserhalb vun 1~1000, oder et gouf versicht, eng gespäichert Äntwert mat GET /responses/{responseId}?stream=true weiderzeféieren
D’Wäerter an de gültege Beräich upassen. Gespäichert Äntwerte ouni stream ofruffen.
401
Schlëssel feelt oder ass ofgelaf bzw. zréckgezunn
Op der API-Schlësselsäit de Status vum Schlëssel iwwerpréiwen an den Headernumm an de Bearer-Präfix kontrolléieren.
403
Keng Berechtegung fir op de Modell zouzegräifen, d’Notzungslimit iwwerschratt, net genuch Credits oder net de Besëtzer vun der Voice
error.message ënnerscheet d’Ursaach. D’Zuele fannt Dir op de Bildschiermer am Abschnitt iwwer d’Kontroll vun de Limiten an der Notzung hei drënner.
404
Modell net fonnt oder mat dësem Schlëssel net zougänglech (och Modeller, deenen hir Ënnerstëtzung ofgeschloss ass), net existente Wee oder CleviDrive-Ausgab, där hir Späicherzäit vun 3 Deeg ofgelaf ass
Fir d’éischt mat GET /models d’Lëscht vun den opruffbare Modeller iwwerpréiwen. De Wee mat der Tabell op der Säit „API opruffen“ vergläichen.
408 · 409 · 413
Upstream-Timeout, Iwwerlaaschtung oder Ufro ze grouss. D’Limit fir d’Zäit bei Voice- a Voice-Weeër ass 5 Minutten, d’Ufroelimit ass 28 MiB
Wann 409 en Retry-After enthält, esou laang waarden. Bei 413 d’Ufro opdeelen.
429
Den Upstream-Provider huet eng Geschwindegkeetslimit gesat
Wann Retry-After zeréckgëtt, dës Zäit onverännert anhalen; soss mat exponentiellem Backoff nei probéieren.
5xx
Temporäre Feeler vum Gateway oder Upstream (inklusiv 503)
Mat exponentiellem Backoff nei probéieren. Wann de Problem widderholl optrëtt, iwwer d’Hëllef an d’Kontaktoptioun mat X-Request-Id mellen.
Neiausféierung
De Gateway generéiert keen eegene 429 a probéiert Upstream-Äntwerte weder onbemierkt nei nach setzt en se an eng Schlaang. Waarden an d’Neiausféierung iwwerhëlt de Client.
Code
Waardezäit
Duerno
409
Wann Retry-After virläit, dës Zäit
Déiselwecht Ufro nach eng Kéier schécken.
429
Wann Retry-After virläit, dës Zäit, soss exponentiellt Backoff
Déiselwecht Ufro nach eng Kéier schécken.
5xx
Exponentiellt Backoff
Wann et widderholl optrëtt, Kontakt ophuelen.
413
Keng Waardezäit
D'Ufro a méi kleng Deeler opdeelen.
Feelertext
De Feelertext huet jee no Spezifikatioun eng aner Struktur. Upstream-Feeler ginn op d'Noriicht reduzéiert a bereinegt weidergeleet; Stackinformatiounen an intern Felder ginn net weidergeleet.
Dëst ass den Text vum OpenAI-kompatibele Wee.
{"error":{"message":"API key is required.","type":"invalid_request_error"}}
Dëst ass den Text vum Anthropic-kompatibele Wee. error.type gëtt duerch de Statuscode festgeluecht.
