Códigos de error
Chat Completions usa el objeto estándar error mostrado abajo. Los errores de voz y catálogo incluyen code, message y request_id. Para consultas, proporciona la cabecera X-Request-Id y la hora de la solicitud.
Las solicitudes fallidas devuelven un estado HTTP fuera de 2xx y un objeto de error:
{"error":{"message":"Invalid request parameter.","type":"invalid_request_error","param":"messages","code":"invalid_request"}}Usa code para la lógica del programa y message como información de diagnóstico.
| HTTP | Código | Significado |
|---|---|---|
| 400 | invalid_request | Modelo, array de mensajes o parámetros de generación inválidos |
| 400 | content_policy_violation | Texto de voz rechazado por la política de contenido |
| 401 | invalid_api_key | Clave inválida, caducada o desactivada |
| 402 | insufficient_balance | Créditos insuficientes |
| 403 | forbidden | Acceso de cuenta o IP restringido |
| 429 | rate_limited | Límite por minuto superado |
| 500 | internal_error | Error del servidor |
| 503 | upstream_unavailable | Servicio de chat o voz no disponible |
| 400 | content_policy_violation | El contenido no superó la revisión de políticas |
| 413 | payload_too_large | Cuerpo de solicitud demasiado grande |
| 504 | timeout | Tiempo de espera agotado |
Comprueba la solicitud y las credenciales antes de reintentar. Espera ante errores temporales. Repetir mensajes puede generar otra respuesta y otros cargos. Si el contenido se rechaza, no reenvíes automáticamente el mismo texto; modifícalo para cumplir la política.
El streaming espera hasta 90 segundos por el primer texto y se detiene tras 60 segundos sin texto nuevo. La salida continua no tiene un límite de duración total fijo y sigue sujeta a max_tokens.