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 erroresunsupported_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 con410 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:
502 con upstream_stream_failure, no una respuesta parcial. Consulta Streaming.
Depura una solicitud
Envía un objetodebug 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.