Límites
Los límites reales de la API, actualizados cada vez que se carga esta página.
Límites de uso
Se cuentan en una ventana deslizante de 60 segundos, por clave de API (por cuenta en un navegador con sesión iniciada).
| Límite | Se cuenta por | Se aplica a |
|---|---|---|
| 30 por minuto | Clave de API | Llamadas que crean o suben:POST /api/v1/characters POST /api/v1/characters/ready DELETE /api/v1/characters/{character_id} PATCH /api/v1/characters/{character_id} POST /api/v1/characters/{character_id}/sheet POST /api/v1/formats/{format_id}/series DELETE /api/v1/formats/{format_id}/series/{series_id} PATCH /api/v1/formats/{format_id}/series/{series_id} POST /api/v1/formats/{format_id}/series/{series_id}/comments POST /api/v1/generate/image POST /api/v1/generate/video POST /api/v1/jobs POST /api/v1/media/{media_id}/touchup POST /api/v1/products POST /api/v1/runs POST /api/v1/runs/from-analysis POST /api/v1/runs/propose POST /api/v1/runs/{run_id}/approve POST /api/v1/runs/{run_id}/redo POST /api/v1/runs/{run_id}/scenes POST /api/v1/runs/{run_id}/scenes/quote POST /api/v1/scripts POST /api/v1/scripts/{job_id}/make POST /api/v1/studio/glowup/captions PUT /api/v1/studio/library POST /api/v1/studio/pack/runs POST /api/v1/studio/{studio_id}/helpers/{name} POST /api/v1/studio/{studio_id}/helpers/{name}/cancel POST /api/v1/studio/{studio_id}/runs POST /api/v1/studio/{studio_id}/series DELETE /api/v1/studio/{studio_id}/series/{series_id} PATCH /api/v1/studio/{studio_id}/series/{series_id} POST /api/v1/studio/{studio_id}/series/{series_id}/comments DELETE /api/v1/studio/{studio_id}/user-cards/{card_id} POST /api/v1/uploads POST /api/v1/uploads/from-library POST /api/v1/uploads/from-url |
| 120 por minuto | Clave de API | Cualquier otra llamada con clave (58 endpoints) |
| 60 por minuto | Dirección IP | Llamadas sin una clave válida |
| 30 por minuto | Clave de API | Herramientas MCP que gastan créditos |
| 120 por minuto | Clave de API | Herramientas MCP gratis |
| 30 por minuto | Cuenta | Ejecuciones desde la zona de pruebas de un modelo |
La API REST y el servidor MCP comparten un contador por clave: las llamadas MCP y REST de una clave se suman.
Cómo es un 429
Si pasas un límite recibes esta respuesta. Espera los segundos de Retry-After (también retry_after en el cuerpo) y vuelve a intentarlo.
Retry-After: 12
Content-Type: application/json {
"error": {
"code": "rate_limited",
"message": "Too many requests. Try again in 12 s.",
"retry_after": 12
}
} - Una llamada rechazada no cobra nada.
- Más de 2 subidas desde un enlace a la vez en una cuenta, o más de 8 en todo el servidor: el mismo 429, con 10 segundos de espera.
Tope diario de créditos por clave
- Opcional, se fija en cada clave al crearla. Cuenta los créditos cobrados menos los devueltos con esa clave en las últimas 24 horas, no un día del calendario.
- Cualquier número entero de 1 a 10.000.000 cr. Sin tope, el único límite es el saldo.
- Un trabajo, una ejecución o un clic de estudio que lo pasaría se rechaza con 402 daily_limit_reached y no se cobra nada.
- Las apps de chat conectadas con inicio de sesión no tienen tope diario salvo que les pongas uno en Ajustes > Conexiones.
- Hasta 50 claves activas por cuenta, según el plan.
Subidas y archivos
| Se aplica a | Límite |
|---|---|
| Una imagen (JPG, PNG, WEBP, GIF, AVIF, HEIC) | 20 MB |
| Un archivo de vídeo o audio | 1024 MB |
| Tiempo de descarga de una subida desde un enlace | 120 s |
| Subidas desde un enlace a la vez, por cuenta | 2 |
| Subidas desde un enlace a la vez, todo el servidor | 8 |
| Los archivos se guardan (más en Inicial y superiores) | 30 días |
Esperas y repeticiones
- Una consulta larga (wait en GET) mantiene la solicitud abierta hasta 50 segundos; las herramientas MCP esperan hasta 45 segundos.
- Hasta 8 consultas largas a la vez por cuenta y 40 en todo el servidor. Una más responde tras una pausa de hasta 2 segundos con el estado actual, sin esperar al final.
- La API no limita por cuenta cuántos trabajos corren a la vez: tu saldo y el tope diario de una clave deciden qué empieza.
- Idempotency-Key: repetir con la misma clave de idempotencia y el mismo cuerpo en menos de 24 horas devuelve la primera respuesta y no cobra otra vez.
Duración de los trabajos y tiempos máximos
Tu plan ejecuta un número fijo de trabajos a la vez; los demás esperan su turno y empiezan solos. Un trabajo que no ha empezado 30 minutos después de llegar su turno falla y te devolvemos los créditos. Una vez empezado, cada modelo tiene el tiempo máximo de abajo: si lo pasa, falla y te devolvemos los créditos.
| Modelo | Id del modelo | Clip más largo | Tiempo máximo |
|---|---|---|---|
| Analizador de anuncios | analysis.ad | Sin dato | 20 min |
| Alargar | audio.song-extend | Sin dato | 15 min |
| Añadir voz | audio.song-vocals | Sin dato | 15 min |
| Cambiar quién canta | audio.song-voice | Sin dato | 15 min |
| Cambiar una parte | audio.song-replace | Sin dato | 15 min |
| Diálogo | audio.dialogue | Sin dato | 10 min |
| Efectos de sonido | audio.sfx | Sin dato | 10 min |
| Música | audio.music | 360 s | 15 min |
| Música de fondo nueva | audio.song-backing | Sin dato | 15 min |
| Separar voz y música | audio.song-split | Sin dato | 15 min |
| Voz en off | audio.tts | Sin dato | 10 min |
| Cambiar formato | edit.resize | Sin dato | 15 min |
| Quitar metadatos | edit.clean | Sin dato | 10 min |
| Subtítulos | edit.captions | Sin dato | 200 min |
| Unir clips | edit.merge | Sin dato | 20 min |
| Flux 2 Pro | image.flux-2-pro | Sin dato | 15 min |
| GPT Image 2 | image.gpt-image-2 | Sin dato | 20 min |
| GPT Image 2.5 | image.gpt-image-2-5 | Sin dato | 20 min |
| Mejorar imagen | image.upscale | Sin dato | 10 min |
| Nano Banana 2 | image.nano-banana-2 | Sin dato | 20 min |
| Nano Banana Pro | image.nano-banana-pro | Sin dato | 20 min |
| Quitar fondo | image.remove-bg | Sin dato | 10 min |
| Seedream 5 Flash | image.seedream-5-flash | Sin dato | 15 min |
| Doblaje con sincronización labial | video.lipsync | Sin dato | 40 min |
| Edición de vídeo con IA | video.video-edit | Sin dato | 45 min |
| Hailuo 2.3 | video.hailuo-2-3 | 10 s | 30 min |
| InfiniTalk | video.infinitalk | Sin dato | 40 min |
| Kling 3.0 | video.kling-3 | 15 s | 40 min |
| Kling 3.0 Motion Control | video.kling-3-motion | Sin dato | 40 min |
| Kling 4.0 | video.kling-4 | 30 s | 40 min |
| Kling Avatar | video.kling-avatar | Sin dato | 60 min |
| Mejorar vídeo | video.upscale | Sin dato | 60 min |
| Seedance 2.0 | video.seedance-2 | 15 s | 45 min |
| Seedance 2.0 Mini | video.seedance-2-mini | 15 s | 30 min |
| Seedance 2.5 | video.seedance-2-5 | 30 s | 45 min |
| Seedance 2.5 final en 1080p | video.seedance-2-5-final | Sin dato | 45 min |
| Veo 3.1 | video.veo-3-1 | 8 s | 45 min |
| Wan 2.2 Animate | video.wan-animate | Sin dato | 45 min |
| Wan 3.0 | video.wan-3 | 30 s | 40 min |
| Wan 3.0 Prime | video.wan-3-prime | 30 s | 40 min |
Clip más largo es la mayor duración que aceptan los campos del modelo, cuando la tiene.
Webhooks
- Cada intento tiene 10 segundos para recibir respuesta de tu endpoint, incluida la resolución DNS.
- 6 intentos en total. Tras un intento fallido esperamos 1 min, 5 min, 30 min, 2 h, 6 h antes del siguiente.
- Cualquier respuesta 2xx cuenta como entregada. No se siguen redirecciones. Solo enlaces https a direcciones públicas, en el puerto 443 / 8443.
- Como mucho 1 intento en curso a la vez por cuenta y 1 por servidor de destino. Hay 4 envíos simultáneos compartidos entre todos los clientes; un endpoint lento ocupa uno de ellos como máximo 10 segundos por intento, incluida la resolución DNS.
- Hasta 100 webhooks en espera por cuenta (aún sin terminar o entre intentos). Por encima, una llamada con callback_url se rechaza con 429 webhook_queue_full antes de cobrar nada.
- Si un trabajo, una ejecución o un clic de estudio sigue sin terminar 14 días después de enviar callback_url, se abandona: la entrega aparece como fallida (not_finished).
- Si el cuerpo supera 256 KB, object llega vacío (null): pide el objeto completo con GET a la url incluida.
- Tus últimas 50 entregas aparecen en el espacio de trabajo; las terminadas se guardan 30 días.
- Tras cambiar el secreto, cada secreto anterior también firma durante 24 horas desde su propio cambio, hasta 5 secretos anteriores a la vez.