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ódigo
Significado
Acción
400
Erro 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=true
Corrixa o valor para que estea dentro do rango. Consulte as respostas gardadas sen stream.
401
A clave falta ou caducou ou foi revogada
Comprobe o estado da clave na pantalla de claves da API e revise o nome da cabeceira e o prefixo Bearer.
403
Non hai permiso para acceder ao modelo, superouse o límite de uso, faltan créditos ou non é o propietario da voz
error.message indica o motivo específico. Consulte os valores na pantalla da sección sobre límites e uso que aparece máis abaixo.
404
O 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ías
Comprobe 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 · 413
Tempo 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 MiB
Se 409 inclúe Retry-After, agarde ese tempo. Para 413, divida a solicitude e envíea por partes.
429
O provedor upstream aplicou un límite de velocidade
Se se devolve Retry-After, siga o seu valor; se non, reintente cun backoff exponencial.
5xx
Erro 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ódigo
Tempo de espera
A continuación
409
Se existe Retry-After, agarde ese tempo
Volva enviar a mesma solicitude.
429
Se existe Retry-After, agarde ese tempo; se non, aplique un retroceso exponencial
Volva enviar a mesma solicitude.
5xx
Retroceso exponencial
Se se repite, póñase en contacto connosco.
413
Sen espera
Divida 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.
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 comprobar
Pantalla da consola
Límite imposto ao meu espazo de traballo
Límite de uso asignado na vista xeral
Intervalo permitido polo plan e saldo
Plan e créditos
Uso real (chamadas por modelo e clave, créditos estimados que se descontarán)