Errores
Códigos de estado HTTP, el cuerpo del error y qué errores conviene reintentar.
Los errores llegan con un estado distinto de 2xx y un cuerpo JSON en el formato de OpenAI:
{
"error": {
"message": "Invalid token (request id: 2026100912391754811973...)",
"type": "new_api_error",
"code": ""
}
}Basa tu lógica en el estado HTTP (y en error.code cuando no esté vacío). El message está pensado para personas y puede cambiar.
Los errores que genera el proveedor del modelo después de aceptar tu solicitud pueden llegar con el formato propio de ese proveedor; en /v1/messages es el formato de Anthropic, { "type": "error", "error": { "type": "...", "message": "..." } }. Ambos formatos incluyen error.message.
Códigos de estado
| Estado | Significado | Qué hacer |
|---|---|---|
400 | La solicitud está mal formada. | Corrige el cuerpo de la solicitud. |
400 con code: invalid_parameter_error en kimi-k3 | El modelo solo acepta valores de muestreo fijos y tu cliente envió otro, a menudo uno predeterminado como temperature 0.7 o top_p 0.9. El mensaje lo indica: Parameter 'temperature'=0.7 is not supported for kimi-k3 model. | No envíes temperature ni top_p, o usa temperature 1 y top_p 0.95. Consulta Límites de muestreo. |
401 | Falta la clave, no es válida, ya venció o agotó su presupuesto. | Revisa la clave en la consola. |
403 | La clave no tiene permiso para esta llamada (lista de modelos o de IP permitidas), o tu saldo es insuficiente. | Ajusta las opciones de la clave o recarga saldo. |
429 | Demasiadas solicitudes. | Reintenta con retroceso exponencial. Consulta Límites de solicitudes. |
503 con code: model_not_found | Ningún proveedor ofrece este ID de modelo. | Revisa el ID de modelo en el catálogo. |
500, 502, 503, 504 | Falló el gateway o el proveedor del modelo. | Reintenta con retroceso. |
Las solicitudes rechazadas con 4xx antes de llegar a un modelo no se cobran.
ID de solicitud
Cada respuesta incluye un encabezado X-Oneapi-Request-Id, y los mensajes de error repiten ese ID. Inclúyelo cuando contactes a soporte.