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"}}.

HTTPcode
400invalid_requestEl cuerpo no es JSON válido, o falta un campo o es incorrecto. El mensaje indica cuál.
400wrong_endpointEl modelo es de otro tipo: los modelos de chat usan /chat/completions, los de imagen /images/generations y los de video /videos.
400size_not_available / format_not_available / too_many_imagesEl 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.
400resolution_not_availableEl modelo de video no se vende en esta resolución.
400video_not_readyEl video aún no está completo; sigue consultando GET /videos/{id}.
400not_a_draft / draft_not_ready / draft_wrong_model / draft_expireddraft_id debe ser un borrador completado del mismo modelo, hecho en los últimos 7 días.
400user_requiredSolo cuentas relay: toda solicitud de chat debe llevar un campo user.
401invalid_api_keyClave de API faltante, incorrecta o revocada.
402insufficient_balance / key_spend_capRecarga tu saldo, o sube el límite diario de la clave.
403account_inactiveLa cuenta está suspendida.
403ip_not_allowedLa clave tiene una lista de IP permitidas y la solicitud llegó desde otra dirección.
404model_not_foundId de modelo desconocido. Consulta GET /models.
404video_not_found / draft_not_foundNo existe ese video o borrador en tu cuenta.
404video_expired / last_frame_expired / image_expired / no_last_frameEl 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.
404not_foundNo existe esa ruta. Consulta Endpoints.
405method_not_allowedMétodo HTTP incorrecto para esta ruta, por ejemplo GET en /chat/completions.
413request_too_largeEl cuerpo de la solicitud es demasiado grande.
429rate_limit_exceeded / concurrency_limit / model_at_capacityReduce el ritmo y reintenta después del tiempo indicado en el encabezado Retry-After.
429model_rate_limit_exceeded / model_concurrency_limitTu 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.
429upstream_rate_limitedEl propio modelo está en su límite de uso. Reintenta en unos segundos; no se te cobró.
429too_many_failed_requestsLa 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.
500internal_errorAlgo falló de nuestro lado. Reintenta, y cita el request_id a soporte si se repite.
502upstream_errorEl proveedor del modelo falló. Es seguro reintentar; no se te cobró.
503upstream_unavailable / billing_unavailable / config_unavailable / model_not_priced / gateway_drainingTemporal. Reintenta con espera creciente.
504upstream_errorEl modelo no respondió a tiempo. Es seguro reintentar; no se te cobró.