Códigos de error de la API
Todos los errores que devuelve la API, con su estado HTTP, su código y qué hacer. Los errores usan el formato de OpenAI.
Errores
Los errores usan el formato de OpenAI: {"error": {"message", "type", "code"}}.
| HTTP | code | |
|---|---|---|
| 400 | invalid_request | El cuerpo no es JSON válido, o falta un campo o es incorrecto. El mensaje indica cuál. |
| 400 | wrong_endpoint | El modelo es de otro tipo: los modelos de chat usan /chat/completions, los de imagen /images/generations y los de video /videos. |
| 400 | size_not_available / format_not_available / too_many_images | El modelo de imagen no genera este tamaño o formato de archivo, o recibió más imágenes de entrada de las que acepta. El mensaje indica qué acepta. |
| 400 | resolution_not_available | El modelo de video no se vende en esta resolución. |
| 400 | video_not_ready | El video aún no está completo; sigue consultando GET /videos/{id}. |
| 400 | not_a_draft / draft_not_ready / draft_wrong_model / draft_expired | draft_id debe ser un borrador completado del mismo modelo, hecho en los últimos 7 días. |
| 400 | user_required | Solo cuentas relay: toda solicitud de chat debe llevar un campo user. |
| 401 | invalid_api_key | Clave de API faltante, incorrecta o revocada. |
| 402 | insufficient_balance / key_spend_cap | Recarga tu saldo, o sube el límite diario de la clave. |
| 403 | account_inactive | La cuenta está suspendida. |
| 403 | ip_not_allowed | La clave tiene una lista de IP permitidas y la solicitud llegó desde otra dirección. |
| 404 | model_not_found | Id de modelo desconocido. Consulta GET /models. |
| 404 | video_not_found / draft_not_found | No existe ese video o borrador en tu cuenta. |
| 404 | video_expired / last_frame_expired / image_expired / no_last_frame | El archivo ya no se conserva, o no se pidió el último fotograma. Los enlaces de imagen duran 1 hora. Los enlaces de video duran una semana; un video que no pudimos copiar a nuestro almacenamiento se sirve desde el proveedor del modelo solo durante 24 horas. |
| 404 | not_found | No existe esa ruta. Consulta Endpoints. |
| 405 | method_not_allowed | Método HTTP incorrecto para esta ruta, por ejemplo GET en /chat/completions. |
| 413 | request_too_large | El cuerpo de la solicitud es demasiado grande. |
| 429 | rate_limit_exceeded / concurrency_limit / model_at_capacity | Reduce el ritmo y reintenta después del tiempo indicado en el encabezado Retry-After. |
| 429 | model_rate_limit_exceeded / model_concurrency_limit | Tu cuenta alcanzó su límite para este modelo en particular. Los demás modelos siguen funcionando; reintenta después del tiempo indicado en Retry-After. |
| 429 | upstream_rate_limited | El propio modelo está en su límite de uso. Reintenta en unos segundos; no se te cobró. |
| 429 | too_many_failed_requests | La clave envió demasiadas solicitudes fallidas seguidas y queda en pausa durante el tiempo indicado en Retry-After. Corrige el error que estabas recibiendo y luego reintenta. |
| 500 | internal_error | Algo falló de nuestro lado. Reintenta, y cita el request_id a soporte si se repite. |
| 502 | upstream_error | El proveedor del modelo falló. Es seguro reintentar; no se te cobró. |
| 503 | upstream_unavailable / billing_unavailable / config_unavailable / model_not_priced / gateway_draining | Temporal. Reintenta con espera creciente. |
| 504 | upstream_error | El modelo no respondió a tiempo. Es seguro reintentar; no se te cobró. |
