Documentación

Errores / Límites de peticiones

Errores

Los errores HTTP contienen un objeto error con un código (code) y un mensaje (message). Una tarea aceptada con éxito puede fallar más tarde; consulta su estado o gestiona el callback de fallo.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Campo	Qué hacer
400	`invalid_request`	Corrige el JSON, el prompt faltante, el rango de parámetros o la URL del archivo multimedia antes de reintentar.
401	`invalid_api_key`	Verifica el Bearer token y asegúrate de que la clave API esté activa.
402	`insufficient_credits`	Añade créditos o reduce el costo de la tarea. La respuesta puede indicar la cantidad de créditos requeridos y disponibles.
403	`forbidden`	Revisa la restricción de cuenta detallada en el mensaje de error.
404	`not_found`	Verifica el ID de la tarea y que la clave pertenezca al usuario que la creó.
429	`rate_limited`	Espera a que transcurra el intervalo indicado en Retry-After antes de intentarlo de nuevo.
500	`internal_error`	Revisa el mensaje de error y los registros de la API. Reintenta con precaución; reenviar una petición de creación puede generar otra tarea facturable.

Límites de peticiones

Creación de tareas: cada clave de API permite de forma predeterminada un máximo de 100 solicitudes por minuto. Actualmente no están disponibles los límites de tarifa personalizados.

Consulta de tareas: cada clave de API permite de forma predeterminada un máximo de 120 solicitudes por minuto. Las solicitudes de consulta y las de creación de tareas se contabilizan de forma independiente.

Las solicitudes de creación de imágenes y vídeos comparten el mismo límite de velocidad (rate limit) de la clave API.

HTTP 429 incluye la cabecera Retry-After: 60 para creación y Retry-After: 5 para consultas. Usa un margen de espera y evita realizar consultas con demasiada frecuencia.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}