Developer guide

Códigos de erro

Accións e regras de reintento por código de estado

Esta páxina resume os códigos de estado devoltos pola pasarela e o seu significado, así como as accións correspondentes a cada código.
Se o upstream devolve un código 4xx ou 5xx, transmítese tal cal; nos demais casos, aplícase a táboa seguinte.
Tamén se describen o formato do corpo dos erros das dúas especificacións compatibles, as regras de error.type compatible con Anthropic e a pantalla da consola onde consultar os límites e o uso.

Código de estado

CódigoSignificadoAcción
400Erro nos valores da solicitude. O límite de 1 a 1000 da lista de modelos compatibles con Anthropic está fóra de rango ou intentouse retomar unha resposta gardada mediante GET /responses/{responseId}?stream=trueCorrixa o valor para que estea dentro do rango. Consulte as respostas gardadas sen stream.
401A clave falta ou caducou ou foi revogadaComprobe o estado da clave na pantalla de claves da API e revise o nome da cabeceira e o prefixo Bearer.
403Non hai permiso para acceder ao modelo, superouse o límite de uso, faltan créditos ou non é o propietario da vozerror.message indica o motivo específico. Consulte os valores na pantalla da sección sobre límites e uso que aparece máis abaixo.
404O modelo non existe ou non se pode acceder a el con esta clave (incluídos os modelos cuxo soporte rematou), a ruta non existe ou o resultado de CleviDrive superou o período de conservación de 3 díasComprobe primeiro a lista de modelos aos que se pode chamar mediante GET /models. Compare a ruta coa táboa da páxina Como chamar á API.
408 · 409 · 413Tempo de espera do upstream esgotado, conxestión ou tamaño da solicitude excedido. Para as rutas de voz e voice, o límite de tempo é de 5 minutos e o límite da solicitude é de 28 MiBSe 409 inclúe Retry-After, agarde ese tempo. Para 413, divida a solicitude e envíea por partes.
429O provedor upstream aplicou un límite de velocidadeSe se devolve Retry-After, siga o seu valor; se non, reintente cun backoff exponencial.
5xxErro temporal da pasarela ou do upstream (incluído 503)Reintente cun backoff exponencial. Se continúa ocorrendo, comuníquenolo mediante Axuda e Contacto, incluíndo X-Request-Id.

Reintento

A pasarela non xera os seus propios 429 nin reintenta en segredo as respostas do upstream ou as introduce nunha cola.
O cliente encárgase de agardar e reintentar.

CódigoTempo de esperaA continuación
409Se existe Retry-After, agarde ese tempoVolva enviar a mesma solicitude.
429Se existe Retry-After, agarde ese tempo; se non, aplique un retroceso exponencialVolva enviar a mesma solicitude.
5xxRetroceso exponencialSe se repite, póñase en contacto connosco.
413Sen esperaDivida a solicitude e envíea.

Corpo do erro

A forma do corpo do erro varía segundo a especificación. Nos erros ascendentes, só se conserva a mensaxe, que se organiza e se transmite; os campos da pila e internos non se transmiten.

É o corpo da ruta compatible con OpenAI.

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

É o corpo da ruta compatible con Anthropic. error.type determínase mediante o código de estado.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}
error.type compatible con Anthropic
Código de estadoerror.type
400invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
529overloaded_error
Outros códigosapi_error

Comprobar os límites e o uso

As cifras dos límites varían segundo o espazo de traballo. Comprobe o motivo do 403 en error.message e, a continuación, consulte as cifras na pantalla seguinte.

Que comprobarPantalla da consola
Límite imposto ao meu espazo de traballoLímite de uso asignado na vista xeral
Intervalo permitido polo plan e saldoPlan e créditos
Uso real (chamadas por modelo e clave, créditos estimados que se descontarán)Uso
Estado da clave (se caducou ou foi revogada)Claves da API
CLEVI

Idioma e rexión

As linguas traducidas automaticamente están marcadas. A dispoñibilidade segue o paquete do sitio publicado.

136 idiomas

Recomendado

1

Asia Oriental

7

Sueste Asiático

11

Asia Meridional

18

Asia Central

5

Oriente Medio e o Cáucaso

10

Europa Occidental e Europa Meridional

16

Reino Unido e Irlanda

4

Europa Setentrional

10

Europa Central e os Balcáns

14

Europa do Leste

5

África Oriental

8

África Occidental e África Central

9

África Meridional

8

América

5

Oceanía

5