Saltar al contenido principal
Decide según error.code y el estado HTTP, no según el texto del mensaje. Todos los errores de Phaseo tienen el mismo cuerpo JSON en todos los endpoints, y su objeto error (code, message, type, param) tiene la forma que leen los SDK compatibles con OpenAI, así que sus excepciones incluyen el mensaje de Phaseo.

Campos de todos los errores

Algunos errores añaden más contexto:

Tipos de error

error.type sigue los tipos de error documentados de OpenAI y se determina según el estado HTTP: Los errores en /v1/messages usan el mismo cuerpo, así que los SDK de Anthropic también encuentran error.type y error.message.

Códigos de error

Reintenta los errores correctos

Define un límite de intentos y un plazo total. Consulta Límites de solicitudes para ver los encabezados de límite de velocidad.

Cuando falla un proveedor

Cuando Phaseo llegó a un proveedor y la solicitud aun así falló, provider_failure_diagnostics incluye category, hint y provider. Categorías:

Cuando un modelo o endpoint no está disponible

Los errores unsupported_model_or_endpoint pueden incluir provider_candidate_diagnostics, provider_enablement, missing_pricing_providers y routing_diagnostics. En conjunto distinguen entre un modelo que aún no está activo, un modelo que no admite el endpoint, la falta de precios y las restricciones de despliegue.

Cuando se retira un modelo

Un modelo retirado se sigue sirviendo mientras algún proveedor lo ofrezca. Cuando ya ninguno lo ofrece, las solicitudes fallan con 410 y model_retired:
model es el modelo que pediste, retired_at es la fecha en que se retiró (o null) y replacement_model es el reemplazo sugerido (o null). Reintentar no sirve; cambia el ID del modelo. Para que estas solicitudes sigan funcionando mientras migras, añade el reemplazo a la lista models de la solicitud o activa el enrutamiento de modelos retirados en el espacio de trabajo. Consulta Obsolescencia y retirada de modelos.

Errores durante un stream

Si una solicitud falla antes de que empiece el streaming, recibes el cuerpo de error JSON anterior. Si falla a mitad del stream, el stream termina con el evento de fallo del endpoint en lugar de un final normal: Trata la salida parcial como incompleta y ofrece reintentar. El frame error de Chat Completions incluye el mismo objeto de error, con error.type determinado por el código:
Una solicitud sin streaming cuyo proveedor falla a mitad devuelve 502 con upstream_stream_failure, no una respuesta parcial. Consulta Streaming.

Depura una solicitud

Envía un objeto debug para obtener trazas de enrutamiento y los payloads del proveedor:
trace_level es summary o full. Los payloads de depuración pueden contener el contenido de tu solicitud, así que úsalos solo en desarrollo o en entornos muy controlados. Consulta debug. Cuando una solicitud falle, revisa la página de estado por si hay incidentes, compara tu payload con la página de referencia del endpoint y registra generation_id junto con el endpoint y el modelo. Incluye generation_id cuando contactes con soporte.
Última modificación el 5 de noviembre de 2026