API Crear clave

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ímiteSe cuenta porSe aplica a
30 por minutoClave de APILlamadas 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 minutoClave de APICualquier otra llamada con clave (58 endpoints)
60 por minutoDirección IPLlamadas sin una clave válida
30 por minutoClave de APIHerramientas MCP que gastan créditos
120 por minutoClave de APIHerramientas MCP gratis
30 por minutoCuentaEjecuciones 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.

HTTP 429
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.
Pon topes a tus claves

Subidas y archivos

Se aplica aLímite
Una imagen (JPG, PNG, WEBP, GIF, AVIF, HEIC)20 MB
Un archivo de vídeo o audio1024 MB
Tiempo de descarga de una subida desde un enlace120 s
Subidas desde un enlace a la vez, por cuenta2
Subidas desde un enlace a la vez, todo el servidor8
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.

ModeloId del modeloClip más largoTiempo máximo
Analizador de anunciosanalysis.adSin dato20 min
Alargaraudio.song-extendSin dato15 min
Añadir vozaudio.song-vocalsSin dato15 min
Cambiar quién cantaaudio.song-voiceSin dato15 min
Cambiar una parteaudio.song-replaceSin dato15 min
Diálogoaudio.dialogueSin dato10 min
Efectos de sonidoaudio.sfxSin dato10 min
Músicaaudio.music360 s15 min
Música de fondo nuevaaudio.song-backingSin dato15 min
Separar voz y músicaaudio.song-splitSin dato15 min
Voz en offaudio.ttsSin dato10 min
Cambiar formatoedit.resizeSin dato15 min
Quitar metadatosedit.cleanSin dato10 min
Subtítulosedit.captionsSin dato200 min
Unir clipsedit.mergeSin dato20 min
Flux 2 Proimage.flux-2-proSin dato15 min
GPT Image 2image.gpt-image-2Sin dato20 min
GPT Image 2.5image.gpt-image-2-5Sin dato20 min
Mejorar imagenimage.upscaleSin dato10 min
Nano Banana 2image.nano-banana-2Sin dato20 min
Nano Banana Proimage.nano-banana-proSin dato20 min
Quitar fondoimage.remove-bgSin dato10 min
Seedream 5 Flashimage.seedream-5-flashSin dato15 min
Doblaje con sincronización labialvideo.lipsyncSin dato40 min
Edición de vídeo con IAvideo.video-editSin dato45 min
Hailuo 2.3video.hailuo-2-310 s30 min
InfiniTalkvideo.infinitalkSin dato40 min
Kling 3.0video.kling-315 s40 min
Kling 3.0 Motion Controlvideo.kling-3-motionSin dato40 min
Kling 4.0video.kling-430 s40 min
Kling Avatarvideo.kling-avatarSin dato60 min
Mejorar vídeovideo.upscaleSin dato60 min
Seedance 2.0video.seedance-215 s45 min
Seedance 2.0 Minivideo.seedance-2-mini15 s30 min
Seedance 2.5video.seedance-2-530 s45 min
Seedance 2.5 final en 1080pvideo.seedance-2-5-finalSin dato45 min
Veo 3.1video.veo-3-18 s45 min
Wan 2.2 Animatevideo.wan-animateSin dato45 min
Wan 3.0video.wan-330 s40 min
Wan 3.0 Primevideo.wan-3-prime30 s40 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.
Cómo funcionan los webhooks