Developer guide

Còdi d’error

Mesuras e règlas de reensagament per còdi d’estat

Aquesta pagina recapitula los còdis d’estat retornats per la passerèla, lor significacion e las mesuras correspondentas a cada còdi.
Se l’amont retorna un còdi 4xx o 5xx, lo transmetèm tal qual; dins los autres cases, seguissèm lo tablèu çai-jós.
Avèm tanben indicat la forma del còs de las errors segon los dos estandards compatibles, las règlas d’error.type compatible amb Anthropic e l’ecran de la consòla per verificar los limits e l’utilizacion.

Còdi d’estat

CòdiSignificacionMesura
400Error dins las valors de la requèsta. Lo limit de la lista dels modèls compatibles amb Anthropic es fòra de 1 a 1000, o una temptativa de reprendre una responsa enregistrada amb GET /responses/{responseId}?stream=trueCorrigissètz la valor per la tornar dins la plaja. Consultatz las responsas enregistradas sens stream.
401Clau absenta, expirada o revocadaVerificatz l’estat de la clau dins la pagina de las claus API e controlatz lo nom de l’entèsta e lo prefix Bearer.
403Accès al modèl pas autorizat, limit d’utilizacion depassat, crèdits insufisents o proprietari de la votz pas reconeguterror.message permet de distinguir la causa. Consultatz las valors dins l’ecran de la seccion çai-jós sus la verificacion dels limits e de l’utilizacion.
404Modèl inexistent o inaccessible amb aquesta clau (incluses los modèls qu’an arribat a la fin de lor supòrt), camin inexistent o resultat de CleviDrive qu’a depassat lo periòde de conservacion de 3 jornsVerificatz d’en primièr la lista dels modèls que pòdon èsser cridats amb GET /models. Comparatz lo camin amb lo tablèu de la pagina «Apelar l’API».
408 · 409 · 413Relambi depassat de l’amont, congestion o talha de la requèsta tròp granda. Per las rotas de votz e d’àudio, lo relambi limit es de 5 minutas e lo limit de la requèsta es de 28 MiBSe 409 inclutz Retry-After, esperatz lo temps indicat. Per 413, partejatz la requèsta.
429Lo provesidor amont aplica una limitacion de velocitatSe Retry-After es present, seguissètz-lo tal qual; senon, tornatz ensajar amb un recuol exponencial.
5xxError temporària de la passerèla o de l’amont (incluses 503)Tornatz ensajar amb un recuol exponencial. Se lo problèma persistís, informatz-ne l’assisténcia e lo contacte amb X-Request-Id.

Reensagament

La passerèla genera pas de 429 en pròpri e torna pas ensajar discretament las responsas de l’amont nimai las plaça en fila.
L’espèra e lo reensagament son efectuats pel client.

CòdeTemps d’espèraPuèi
409Se Retry-After es present, esperatz aqueste tempsTornatz enviar la meteissa requèsta.
429Se Retry-After es present, esperatz aqueste temps; autrament, aplicatz un recuòl exponencialTornatz enviar la meteissa requèsta.
5xxRecuòl exponencialSe lo problèma se repetís, contactatz-nos.
413Cap d’espèraDivisatz la requèsta.

Còs de l’error

La forma del còs de l’error varia segon l’especificacion. Las errors en amont son netejadas e transmesas en conservant sonque lo messatge; la traça e los camps intèrnes son pas transmeses.

Es lo còs de la rota compatible amb OpenAI.

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

Es lo còs de la rota compatible amb Anthropic. error.type es determinat pel còdi d’estat.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}
error.type compatible amb Anthropic
Còdi d’estaterror.type
400invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
529overloaded_error
Autres còdisapi_error

Verificar los limits e l’utilizacion

Los limits dependon de cada espaci de trabalh. Verificatz la rason del 403 dins error.message, puèi consultatz las valors dins l’ecran çai-jós.

Elements de verificarEcran de la consòla
Limit aplicat a mon espaci de trabalhLimit d’utilizacion atribuit dins l’apercebut
Plaja autorizada pel plan e saldoPlan e crèdits
Utilizacion actuala (nombre d’apèls per modèl e per clau, crèdits estimats dedusits)Utilizacion
Estat de la clau (expirada o revocada)Clau API
CLEVI

Lenga e region

Las lengas tradusidas automaticament son marcadas. La disponibilitat seguís lo paquet del site publicat.

136 lengas

Recomandat

1

Asia Orientala

7

Asia del Sud-Èst

11

Asia del Sud

18

Asia Centrala

5

Orient Mejan e Caucàs

10

Euròpa Occidentala e Meridionala

16

Bretanha e Irlanda

4

Euròpa del Nòrd e Baltic

10

Euròpa Centrala e Balcans

14

Euròpa Orientala

5

Àfrica Orientala e la Bana

8

Àfrica Occidentala e Centrala

9

Àfrica Australa

8

Las Americas

5

Lo Pacific

5