LogoLogoDocumentación de la API
LogoLogoDocumentación de la API
Página de inicio
Visión generalAutenticación e idempotenciaGeneración de imágenesEdición de imágenesConversión de imágenesTrabajos y espera acotadaCréditosErroresLímites de peticiones y concurrenciaRegistro de cambios de la API
Documentación de la API

Límites de peticiones y concurrencia

Límites por clave y límites de trabajos por cuenta

Los límites protegen la disponibilidad del servicio y se aplican antes de cualquier trabajo costoso.

LímiteValor actual
Creación de trabajos10 peticiones por minuto y clave de API, sumando todos los endpoints de creación
Lecturas autenticadas120 peticiones por minuto y clave de API
Trabajos activos8 trabajos en queued o processing por cuenta
Tamaño de lotehasta 4 salidas por trabajo de generación o edición
Espera acotadahasta 30 segundos

Superar un límite de peticiones o el de trabajos activos devuelve HTTP 429 con RATE_LIMIT_EXCEEDED. Aplica retroceso exponencial con variación aleatoria y respeta Retry-After cuando esté presente. Las claves de idempotencia deben permanecer sin cambios mientras reintentas la misma petición lógica.

El límite de trabajos activos es de toda la cuenta, aunque uses varias claves de API. Los trabajos completados no cuentan.

Con el tamaño de lote máximo, ocho trabajos activos de generación o edición pueden pedir hasta 32 salidas en total. Es un límite de capacidad de envío, no una garantía de que todas las salidas se ejecuten a la vez.

Errores

Envolturas de error estables, códigos y estados HTTP

Registro de cambios de la API

Cambios versionados del contrato público