Developer guide
Cod de eroare
Acțiuni și reguli de reîncercare în funcție de codul de stare
Gateway-ul transmite codul neschimbat atunci când upstream-ul returnează 4xx·5xx; în celelalte cazuri, urmează regulile din tabelul de mai jos.
400·401·403·404·413 sunt coduri care necesită corectarea solicitării sau a configurării, iar 409·429·5xx sunt coduri pentru care clientul așteaptă, apoi trimite din nou aceeași solicitare.
Formatul corpului erorii diferă în funcție de specificație, iar error.type de pe ruta compatibilă cu Anthropic este determinat de codul de stare.
Motivul pentru 403 se identifică prin error.message, iar valorile limitelor și ale utilizării se verifică în consola de administrare.
Cod de stare
| Cod | Semnificație | Acțiune |
|---|---|---|
| 400 | Valoarea solicitată este nevalidă. Valoarea limit pentru lista de modele compatibile cu Anthropic este în afara intervalului 1–1000 sau s-a încercat preluarea în flux a unui răspuns salvat prin GET /responses/{responseId}?stream=true. | Corectați valoarea astfel încât să se încadreze în interval. Consultați răspunsurile salvate fără stream. |
| 401 | Cheia lipsește sau este expirată ori revocată. | Verificați starea cheii în ecranul cheilor API și verificați numele antetului și prefixul Bearer. |
| 403 | Nu aveți permisiunea de a accesa modelul, ați depășit limita de utilizare, nu aveți suficiente credite sau nu sunteți proprietarul vocii. | Verificați motivul în error.message, iar valorile numerice le puteți consulta în secțiunea de mai jos privind limitele și verificarea utilizării. |
| 404 | Modelul nu există sau nu poate fi accesat cu această cheie (inclusiv modelele pentru care asistența s-a încheiat). Este returnat și atunci când ați apelat o rută inexistentă sau ați solicitat un rezultat CleviDrive după expirarea perioadei de păstrare de 3 zile. | Verificați mai întâi lista modelelor care pot fi apelate folosind GET /models. Comparați ruta cu tabelul de pe pagina Apelarea API-ului. |
| 408 · 409 · 413 | Este vorba despre expirarea timpului de așteptare în upstream, congestionare sau depășirea dimensiunii solicitării. Limita de timp pentru rutele de voce și voice este de 5 minute, iar limita solicitării este de 28 MiB. | Dacă 409 include Retry-After, așteptați perioada indicată și apoi trimiteți din nou aceeași solicitare. Pentru 413, împărțiți solicitarea și trimiteți-o în mai multe părți. |
| 429 | Furnizorul upstream a aplicat o limitare a ratei. | Dacă există Retry-After, așteptați perioada indicată și apoi încercați din nou; în lipsa acestuia, reîncercați folosind backoff exponențial. |
| 5xx | Este o eroare temporară a gateway-ului sau a upstream-ului (inclusiv 503). | Reîncercați folosind backoff exponențial. Dacă problema persistă, contactați-ne. |
Nu returnăm 402. Lipsa creditelor și depășirea limitei de utilizare sunt returnate ambele ca 403.
Reîncercări și contactarea echipei
Gateway-ul nu generează propriile erori 429 și nu reîncearcă și nu pune în coadă răspunsurile upstream în numele dvs. Așteptarea și reîncercarea sunt efectuate de client.
Când ne contactați, transmiteți-ne informațiile prin secțiunea Ajutor și contact, împreună cu X-Request-Id. Dacă nu ați trimis X-Request-Id, valoarea emisă de server se află în antetul request-id al răspunsului compatibil cu Anthropic.
Corpul erorii
Formatul corpului erorii diferă în funcție de specificație. Pentru erorile upstream, păstrăm doar mesajul și îl transmitem într-o formă simplificată; stiva și câmpurile interne nu sunt transmise.
Corpul erorii pentru ruta compatibilă cu OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Corpul erorii pentru ruta compatibilă cu Anthropic. error.type este determinat în funcție de codul de stare, conform tabelului de mai jos.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Cod de stare | 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 |
| Alte coduri | api_error |
Verificarea limitelor și a utilizării
Valorile limitelor diferă în funcție de spațiul de lucru. Verificați motivul pentru codul 403 în error.message, apoi consultați valorile în ecranele următoare.
| De verificat | Ecranul consolei |
|---|---|
| Limita aplicată spațiului de lucru | Limita de utilizare alocată din prezentarea generală |
| Intervalul permis de plan și soldul | Plan și credite |
| Utilizarea efectivă (numărul de apeluri per model și per cheie, creditele estimate deduse) | Utilizare |
| Starea cheii (dacă a expirat sau a fost revocată) | Cheie API |