API de Seedance 2.5: Guía para desarrolladores sobre endpoints, autenticación y generación de video

API de Seedance 2.5: Guía para desarrolladores sobre endpoints, autenticación y generación de video

Seedance 2.5 es un modelo de video multimodal de larga duración, lo que significa que la API que lo impulsa es asíncrona, no un simple parquete petición-respuesta. Envías una tarea de generación, haces sondeo hasta que se completa y descargas el resultado. Una vez que entiendes ese patrón, además del endpoint, el encabezado de autenticación y los campos del payload para duración, resolución y referencias, el resto es directo.

Esta guía recorre el contrato completo de la API de Seedance 2.5: el endpoint, la autenticación, el cuerpo de la solicitud, el sondeo asíncrono y ejemplos funcionales en curl y Python. Está orientada a la ruta de la api-platform de PixMind, que replica el contrato de ByteDance para el modelo. También añade una comparación lado a lado con los patrones de las API de Seedance 2.0 y Kling, un caso de estudio de pipeline de producción de extremo a extremo, recursos para desarrolladores de terceros y un FAQ ampliado que cubre límites de tasa, concurrencia, webhooks y comprobación de créditos. Todos los detalles de endpoint y autenticación están verificados contra el backend en producción a fecha de 2026-07-31.

Resumen completo del modelo Seedance 2.5

Puntos clave

• Endpoint: POST /api-platform/v1/generations para crear una tarea; GET /api-platform/v1/task/{task_id} para hacer sondeo del resultado.
• Autenticación: Authorization: Bearer <API_KEY> (o el encabezado X-API-Key); crea una clave con alcance de video en el panel de PixMind.
• Payload: { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }.
• Es asíncrono: la llamada de creación devuelve un taskId; haces sondeo hasta que status sea ready y luego lees videoUrl.
• Forma entre proveedores: Seedance 2.5, Seedance 2.0 y Kling usan todos el mismo patrón de enviar y luego hacer sondeo. Difierieren en la ruta del endpoint, el presupuesto de referencias y los nombres de campos.
• Patrón de producción: añade un Idempotency-Key al crear, haz sondeo con reintentos limitados y backoff, verifica los créditos antes de enviar y mantén una ruta más económica como respaldo para iterar.
• El acceso a la API llegará pronto en PixMind; la ruta está documentada y lista, y la conexión con el backend está en fase de cierre.

Requisitos previos: consigue una API Key

Las llamadas a Seedance 2.5 se autentican con una API Key asociada a tu cuenta. Crea una en el panel de la api-platform de PixMind y guárdala de forma segura; trátala como cualquier secreto. Carga la clave desde una variable de entorno en tu código en lugar de commitizarla en el control de versiones:

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

Crear una API Key

En PixMind, los permisos de la clave se limitan por carga de trabajo (imagen / video). Asegúrate de que tu clave tenga el permiso de video habilitado antes de llamar a Seedance 2.5.

Nota para desarrolladores: Rota las claves por entorno (dev / staging / prod) y limita cada clave al mínimo de cargas de trabajo que necesite. Una clave de staging con solo alcance de video no puede filtrarse al pipeline de imagen, lo que reduce el radio de explosión si la clave se ve comprometida. Reemite las claves con una cadencia fija y registra la marca temporal del último uso, para que las claves inactivas sean fáciles de localizar y revocar.

Ver: recorrido por el flujo de trabajo de Seedance 2.5

La forma más rápida de entender la mejora de la versión 2.5 antes de escribir código es ver el material de demostración oficial y los análisis de la comunidad. Estos dos recorridos cubren la generación nativa de 30 segundos, la salida en 4K, la edición a nivel de región y el flujo de 50 referencias que la API expone:

alternativa noscript: Demo de Seedance 2.5 en YouTube, cubre clips nativos de 30 segundos, edición a nivel de región y 50 referencias multimodales.

Para una discusión editorial más profunda sobre lo que las mejoras del flujo de trabajo significan para un pipeline de producción, el análisis "Seedance 2.5 Changes Everything" vale la pena verlo junto con el reel oficial:

alternativa noscript: Seedance 2.5 Changes Everything en YouTube.

El contrato de la API de Seedance 2.5

Endpoint

Crear una tarea de generación:

POST /api-platform/v1/generations

Hacer sondeo hasta que se complete:

GET /api-platform/v1/task/{task_id}

El endpoint de creación es el punto de entrada unificado de generación: lee el campo model y despacha en consecuencia. Envía model: "seedance-2.5" y la ruta se encarga del pipeline de video.

Autenticación

Envía la API Key como un token Bearer (compatible con el SDK de OpenAI):

Authorization: Bearer $PIXMIND_API_KEY

El middleware de autenticación también acepta el encabezado X-API-Key si prefieres esa forma. Ambas opciones son compatibles; elige una y úsala de forma consistente en todo tu código de cliente, para que los registros y los reintentos sean más fáciles de rastrear.

Cuerpo de la solicitud

Sobre las referencias: Seedance 2.5 acepta hasta 50 entradas multimodales en una sola solicitud, imágenes, videos, texto y audio combinados. Asigna a cada referencia un rol explícito único (identidad, forma, movimiento, paleta, ritmo) y elimina los recursos que compitan por la misma propiedad.

Cómo se compara la API de Seedance 2.5 con Seedance 2.0 y Kling

La mayoría de las API actuales de generación de video comparten la misma forma asíncrona: un POST para crear la tarea, un GET para hacer sondeo hasta que termine. Donde difieren es en la ruta del endpoint, la convención de autenticación, el presupuesto de referencias y los nombres de los campos en el payload. La tabla a continuación mapea esas diferencias para las tres API que los desarrolladores comparan con más frecuencia al planificar una integración.

Observación de primera mano: La forma asíncrona compartida significa que el código de cliente es reutilizable entre proveedores. Envuelve el bucle de crear y hacer sondeo en una sola función generate_video(model, payload) y cambia el ID del modelo, y podrás hacer pruebas A/B de Seedance 2.5, Seedance 2.0 Fast y Kling desde el mismo arnés. Esa es la forma más barata de elegir la ruta correcta por plano sin reescribir el código de integración.

La conclusión práctica: si tu equipo ya construyó un cliente de sondeo para Seedance 2.0, adoptar la versión 2.5 es un cambio de cadena de modelo más los nuevos campos de referencia y duración. No necesitas rediseñar la integración.

Comparación de modelos Seedance 2.5 vs Kling

Paso 1: Crea una tarea de generación

Aquí tienes una solicitud de creación mínima, un clip de 5 segundos, 720p, 16:9 con un prompt de texto. El encabezado Idempotency-Key es opcional pero recomendable para cualquier envío a producción:

curl -X POST https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A courier in a yellow jacket cycling through a neon-lit rainy Tokyo street at night, tracking shot, cinematic, no text",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Una respuesta exitosa devuelve un ID de tarea. Aquí no obtienes el video, obtienes un identificador para hacer sondeo:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "type": "video",
    "status": "processing"
  }
}

Si ves code: 400 con "El modelo no existe o no está configurado", la ruta del backend para seedance-2.5 aún no se ha habilitado en ese endpoint. Este es el estado de "Próximamente" en PixMind mientras se finaliza la conexión.

Paso 2: Haz sondeo de la tarea hasta que esté lista

La generación de video es asíncrona. Haz sondeo del endpoint de tareas con el taskId del paso 1:

curl -X GET https://aihub-admin.aimix.pro/open-api/v1/task/47264 \
  -H "Authorization: Bearer $PIXMIND_API_KEY"

El campo status pasa por pending, luego processing y finalmente ready. Haz sondeo cada 3 a 5 segundos. Cuando la tarea está lista, la respuesta incluye la URL final del video:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "status": "ready",
    "progress": 100,
    "videoUrl": "https://.../seedance-2-5-47264.mp4",
    "coverUrl": "https://.../seedance-2-5-47264-cover.webp"
  }
}

Los estados de fallo terminal son failed, error, canceled y cancelled. Manéjalos y expón el campo description a tus registros.

Nota para desarrolladores: Intervalos de sondeo de 3 a 5 segundos están bien para una sola tarea, pero se multiplican rápido a escala. Para una cola de 20 tareas, prefiere un único bucle despachador que haga sondeo de cada tarea abierta una vez por ciclo, con backoff exponencial (5 s, 5 s, 10 s, 15 s, hasta un máximo de 30 s) a medida que las tareas envejecen. Esto mantiene el volumen de peticiones educado sin estirar la latencia p99 de todo el lote.

Paso 3: Descarga y usa el resultado

Una vez que status es ready, descarga videoUrl (y opcionalmente coverUrl para un fotograma de póster). El archivo es un MP4 estándar; transcodifícalo, aloja o incrústalo según lo requiera tu aplicación.

Para una landing page web, normalmente lo comprimirías a un clip H.264 de 8 a 10 segundos con fast-start para autoplay, extraerías un póster WebP y alojarías ambos en tu propio CDN. (PixMind aloja el material de sus casos de Seedance 2.5 en cdn.pixmind.io.) No enlaces directamente al videoUrl alojado por la API en producción, ya que la URL de la API no tiene garantía de persistir.

Ejemplo completo en Python

Aquí tienes un fragmento Python completo y ejecutable que crea una tarea, hace sondeo hasta que está lista e imprime la URL del video. Añade un Idempotency-Key, un bucle de reintentos limitado y un límite de tiempo de espera, que son las tres cosas que un cliente de producción necesita y que un ejemplo "hola mundo" normalmente omite:

import time
import uuid
import requests

API_BASE = "https://aihub-admin.aimix.pro"
API_KEY = "your-pixmind-api-key"  # alcance: video

GEN = f"{API_BASE}/api-platform/v1/generations"
TASK = f"{API_BASE}/open-api/v1/task"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# 1. Crear con una clave de idempotencia para que un reintento no inicie una segunda tarea facturable
payload = {
    "model": "seedance-2.5",
    "prompt": "A 30-second continuous hero shot: a character walking through a neon city that flows into a product reveal",
    "duration": 30,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": True,
}
headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
create = requests.post(GEN, headers=headers, json=payload, timeout=30).json()
task_id = create["data"]["taskId"]
print(f"Task created: {task_id}")

# 2. Sondeo con reintentos limitados y backoff suave
max_attempts, delay = 100, 5
for attempt in range(max_attempts):
    time.sleep(delay)
    t = requests.get(f"{TASK}/{task_id}", headers=HEADERS, timeout=15).json()
    status = t["data"]["status"].lower()
    print(f"attempt={attempt + 1} status={status} progress={t['data'].get('progress', 0)}%")
    if status in ("ready", "succeeded", "completed"):
        print("Video URL:", t["data"]["videoUrl"])
        break
    if status in ("failed", "error", "canceled", "cancelled"):
        raise RuntimeError(f"Task failed: {t['data']}")
    delay = min(delay + 2, 30)  # backoff, máximo 30 s
else:
    raise TimeoutError(f"Task {task_id} did not finish in {max_attempts * 5}s")

Caso de estudio de extremo a extremo: un pipeline de video de producto de 30 segundos

Esta es la parte que la mayoría de guías de API omiten: cómo un equipo real encadena el contrato anterior en un pipeline de producción repetible. El escenario es un equipo creativo de cuatro personas en una marca D2C que produce un video heroico de 30 segundos para el lanzamiento de un producto, con un presupuesto fijo y una fecha límite estricta. El patrón a continuación es la forma que entrega de forma consistente a tiempo.

Visión general del pipeline

El equipo divide el trabajo en cuatro etapas: iteración (pruebas A/B baratas en Seedance 2.0 Fast), generación final (una ejecución de Seedance 2.5 a 1080p / 30 s), revisión y ediciones de región (regeneración dirigida de región con Seedance 2.5) y entrega (transcodificación, póster, subida al CDN). Cada etapa usa el mismo código de cliente; solo cambian el ID del modelo y el payload. Esta separación es lo que hace que el pipeline sea repetible entre campañas.

Asignación de referencias

Antes de cualquier llamada a la API, el equipo asigna a cada referencia un único rol explícito, capturado en una hoja de cálculo compartida para que el prompt y el payload se mantengan sincronizados. Cinco referencias del presupuesto de 50 entradas, cada una con una sola función:

El prompt mapea cada uno de forma explícita: "mantén intacto el personaje de @Image 1; coincide con el producto de @Image 2; usa @Video 1 solo para el movimiento de cámara; alinea los cortes con @Audio 1." El mapeo es el contrato entre la dirección creativa y el payload de la API. Si una referencia no tiene rol asignado, no entra en la solicitud.

Etapa de iteración (control de costos)

Antes de gastar en una ejecución de 30 segundos con la versión 2.5, el equipo valida el prompt y las referencias en Seedance 2.0 Fast a 5 segundos y 720p. Es la misma llamada POST /api-platform/v1/generations con model: "seedance-2.0-fast". Tres iteraciones cuestan una fracción de una ejecución de la 2.5 y exponen conflictos de referencias antes de comprometer el presupuesto. El despachador registra el taskId, el estado y los segundos transcurridos de cada iteración para que el director creativo pueda comparar variantes lado a lado.

Observación de primera mano: Los equipos que se saltan esta etapa y van directos a una generación de 30 segundos con la versión 2.5 suelen consumir tres o cuatro ejecuciones a precio completo arreglando conflictos de prompt que podrían haber detectado en Fast. La etapa de iteración es la parte del pipeline con mayor ROI, y los equipos que entregan de forma fiable son los que la tratan como obligatoria.

Generación final (Seedance 2.5 a 30 s / 1080p)

Cuando la iteración en Fast confirma que el prompt se lee bien, el equipo envía la generación real: model: "seedance-2.5", duration: 30, resolution: "1080p", con las cinco referencias adjuntas y el prompt completo mapeado por roles. La llamada de creación incluye un Idempotency-Key para que un reintento de red desde el runner de CI no inicie una segunda tarea facturable. El director creativo revisa el registro de envío del taskId final antes de que el despachador tenga permiso para confirmarlo, una verificación de un minuto que evita errores caros de prompt.

Sondeo, errores e idempotencia

Un único despachador hace sondeo de la tarea cada 5 segundos con backoff hasta 30 segundos, con un máximo de 100 intentos (unos 8 minutos). Los fallos terminales (failed, error) desencadenan un único reintento con un nuevo Idempotency-Key solo si la descripción del fallo indica un problema transitorio del backend. Los errores de referencias o de prompt se exponen al director creativo y se corrigen antes de reenviar, no se reintenta a ciegas. El despachador escribe una línea de registro estructurado por intento (ID de tarea, estado, progreso, segundos transcurridos) para que el coste y la latencia sean auditables después del lanzamiento.

Ediciones de región

En la revisión, el cliente pide cambiar el producto en la estantería derecha del plano final. El equipo envía una tarea de edición a nivel de región que solo afecta a esa zona, preservando el movimiento y la identidad del resto del clip. Esta es la característica más valiosa de la versión 2.5 para trabajo de cliente: un ciclo de un día se convierte en una regeneración de 10 minutos. El pipeline mantiene el taskId original y el taskId de la edición enlazados en el registro del proyecto, de modo que la línea de cada fotograma entregado es trazable.

Entrega

El videoUrl en estado ready se descarga, se transcodifica a H.264 con fast-start para autoplay web, se empareja con un póster WebP extraído de coverUrl y se sube al CDN del equipo. Los recursos finales se publican en la landing page y se revisan fotograma a fotograma (identidad, manos, geometría del producto, logotipos, sincronización de audio) antes de la publicación.

Disciplina de costos

El pipeline limita el gasto en tres puntos. Primero, las iteraciones se ejecutan en Fast en lugar de en la 2.5. Segundo, una comprobación previa de créditos antes de cada envío a la versión 2.5 aborta si el saldo de la billetera está por debajo del umbral para la duración y resolución elegidas. Tercero, un presupuesto estricto de tareas por lanzamiento en el despachador impide enviar nuevas tareas una vez alcanzado. El precio de Seedance 2.5 no está publicado, así que el equipo trata cualquier cifra por segundo como una estimación y consulta el generador en vivo para los créditos actuales antes de cada campaña.

Cómo manejar las 50 referencias multimodales

La característica estrella, hasta 50 entradas multimodales, aparece en el payload como arrays de URLs públicas:

{
  "model": "seedance-2.5",
  "prompt": "Keep the character from the first image unchanged; use the video for body motion and the audio for rhythm",
  "duration": 20,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "reference_images": ["https://cdn.example.com/character.jpg", "https://cdn.example.com/product.jpg"],
  "reference_videos": ["https://cdn.example.com/motion.mp4"],
  "generate_audio": true
}

Todas las URLs de referencia deben ser accesibles públicamente. Asigna a cada una un único rol y describe ese rol en el prompt ("usa @Video 1 solo para el movimiento del cuerpo"), para que el modelo sepa qué entrada controla qué propiedad.

Nota para desarrolladores: Valida previamente que cada URL de referencia devuelva HTTP 200 con el content-type esperado antes de enviar. Un 403 en un recurso protegido por CDN es la causa más común de tareas failed en producción, y desperdicia un presupuesto completo de generación. Una comprobación HEAD de dos líneas en tu cliente evita toda esta clase de fallos. Usa también URLs estables direccionadas por contenido (por ejemplo, con un hash o una versión en la ruta), de modo que cambiar un recurso a mitad de campaña no altere de forma silenciosa lo que recibe el modelo.

Manejo de errores e idempotencia

• 401 "API Key no válida", clave incorrecta o la clave no tiene alcance de video. Verifica la clave y sus permisos.
• 400 "El modelo no existe o no está configurado", la ruta de seedance-2.5 aún no está habilitada en este backend. En PixMind este es el estado de "Próximamente".
• 4001 "Saldo insuficiente", la solicitud es válida pero tu billetera no tiene créditos; la tarea no se crea.
• 429 límite de tasa, haz backoff exponencial y reintenta; el endpoint de creación aplica límites de tasa de solicitud y de concurrencia por clave. Si te topas con esto de forma habitual, contacta con soporte para subir los límites o escalona los envíos en intervalos cortos.
• 502 / 504 puerta de enlace, transitorio; reintenta la llamada de creación con el mismo Idempotency-Key para que el backend desduplique y no inicies una segunda tarea facturable.
• Tiempo de espera de sondeo, limita los intentos (por ejemplo 100 × 5 s, unos 8 minutos) y trata el tiempo de espera como un fallo con un único reintento.

Para producción, pasa un encabezado Idempotency-Key en cada llamada de creación para que un reintento del cliente no inicie una segunda tarea facturable. Usa un UUID por tarea lógica (no por intento HTTP), generado una sola vez y almacenado de tu lado, para que la misma generación lógica se desduplique entre reintentos, reruns de CI y reprocesos de cola. El patrón es: genera el UUID cuando el usuario (o el job runner) decide crear la tarea, persiste antes de la primera llamada HTTP y reutilízalo para cada reintento de esa misma tarea lógica.

Recursos para desarrolladores de terceros

El contrato anterior es la vía de implementación en PixMind. Para contexto más profundo sobre el modelo subyacente de ByteDance y la superficie oficial de la API, estos son los recursos a los que los desarrolladores recurren con más frecuencia, verificados el 2026-07-31:

• Página de recursos de Seedance 2.5 en BytePlus, ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5. El encuadre propio de ByteDance de la versión 2.5, orientado a la generación de video publicitario y demos de producto. Útil para la narrativa de capacidades y los casos de uso que el propio ByteDance persigue. Listado verificado, 2026-07-31.
• Documentación de la API de BytePlus ModelArk, la superficie oficial de desarrollador para invocar Seedance a través de la nube de ByteDance. Referencia cruzada de nombres de campos y modos cuando necesites confirmar qué expone la ruta conectada, y luego replica esos nombres en tu cliente.
• Documentación de Volcengine 火山方舟 (Volcano Engine Ark), volcengine.com/docs/82379. El endpoint nacional (China) para la misma familia de modelos. El patrón asíncrono de enviar y hacer sondeo es el mismo que en la ruta de PixMind; los nombres de campo y el flujo de autenticación difieren ligeramente. Listado verificado, 2026-07-31; confirma la ruta en vivo antes de integrar.
• Guía de recreación de la demo de MakeFun AI, makefun.ai/seedance-2-5-demo-videos/. Recorre la recreación de los flujos de trabajo con muchas referencias del demo de BytePlus ModelArk. Útil cuando quieres reproducir el look oficial antes de diseñar tu propio prompt.
• Análisis de la comunidad, el análisis de la versión 2.5 de Topview/Medium, la cobertura FORCE de Pixo y la guía completa de ToSea cubren todos las mejoras del flujo de trabajo desde un ángulo editorial. Útiles para contexto, no para detalles de endpoint; confirma siempre las especificaciones técnicas contra la API en vivo.

Nota para desarrolladores: Las guías de terceros envejecen rápido. Trata cualquiera de ellas como un punto de partida y confirma rutas de endpoint, nombres de campo y costes en créditos contra la ruta conectada el día que integres. Los detalles de endpoint y autenticación de esta guía están verificados el 2026-07-31, pero el modelo sigue desplegándose, así que vuelve a comprobarlo antes del lanzamiento a producción.

FAQ de la API de Seedance 2.5

¿Cuál es el endpoint de la API de Seedance 2.5?

Crea una tarea con POST /api-platform/v1/generations, luego haz sondeo con GET /api-platform/v1/task/{task_id} hasta que status sea ready. El campo del modelo es seedance-2.5.

¿Cómo me autentico en la API de Seedance 2.5?

Envía tu API Key como Authorization: Bearer <key>. El encabezado X-API-Key también se acepta. Crea una clave con permiso de video en el panel de PixMind y cárgala desde una variable de entorno en lugar de incrustarla en el código fuente.

¿Está disponible la API de Seedance 2.5 en PixMind?

La ruta está documentada y lista; el acceso al backend está en fase de finalización y el modelo está marcado como "Próximamente". La página /api-platform/models/seedance-2-5 tiene la referencia de endpoint y parámetros, y la página /ai-video/seedance-2-5 aloja el generador web mientras tanto.

¿Cuántas referencias puedo enviar en una solicitud de Seedance 2.5?

Hasta 50 entradas multimodales, imágenes, videos, texto y audio combinados, en una sola solicitud. Esto es un salto desde las 9 de Seedance 2.0. Cada referencia debe ser una URL accesible públicamente.

¿La API de Seedance 2.5 devuelve el video de forma síncrona?

No. La generación de video es asíncrona. La llamada de creación devuelve un taskId; haces sondeo del endpoint de tareas hasta que status sea ready, y entonces lees videoUrl. Una generación típica de 30 segundos tarda varios minutos, así que diseña tu cliente para sondeo, no para bloqueo.

¿Cuáles son los límites de tasa y de concurrencia?

El endpoint de creación aplica límites de tasa de solicitud y de concurrencia por clave. Si los superas, la respuesta devuelve 429 y deberías aplicar backoff exponencial. Para cargas por lotes (más de un puñado de tareas concurrentes), escalona los envíos en intervalos cortos y contacta con soporte para subir los límites si te topas con 429 de forma habitual. Los límites numéricos exactos se ajustan por cuenta, así que verifícalos en tu propia clave antes de diseñar un trabajo por lotes grande.

¿La API de Seedance 2.5 soporta webhooks o callbacks?

La ruta verificada de PixMind usa solo sondeo, no callbacks de tipo push. Si tu arquitectura necesita notificaciones push, ejecuta un único despachador que haga sondeo del endpoint de tareas y emita un webhook a tus servicios secundarios cuando status alcance un estado terminal. Esto mantiene la integración simple y evita acoplar tu pipeline a una URL de callback que puede cambiar entre entornos.

¿Cuántas tareas concurrentes puedo ejecutar?

La concurrencia está limitada por los topes por clave de tu key y por tu saldo de créditos. Para trabajo de 30 segundos a 1080p, espera ejecutar un puñado de tareas en paralelo más que decenas. Trata el tope en vivo como "verificado en tu cuenta": envía un lote pequeño de calibración, mide cuántas tareas pasan de pending a processing simultáneamente y dimensiona tu cola contra ese número.

¿Qué formato de video devuelve la API?

La tarea lista devuelve un videoUrl que apunta a un archivo MP4 estándar, además de un coverUrl para un fotograma de póster. Descarga y transcodifica al formato que tu objetivo de entrega necesite (H.264 con fast-start para web, codificaciones verticales para social, ProRes para masterización de edición). No enlaces directamente al videoUrl alojado por la API en producción porque no tiene garantía de persistir; copia el archivo a tu propio CDN cuando esté ready.

¿Cómo compruebo los créditos antes de enviar?

Consulta el generador en vivo para el coste en créditos actual de tu duración y resolución elegidas, y luego verifica tu saldo de billetera. La API devuelve 4001 "Saldo insuficiente" si el saldo es demasiado bajo, momento en el que la tarea no se crea. Para pipelines de producción, añade una comprobación de saldo previa al envío que aborte de forma temprana si el saldo está por debajo del umbral por tarea, para no encolar trabajo que la billetera no pueda cubrir.

¿Cómo soluciono el error "El modelo no existe o no está configurado"?

Esta respuesta 400 significa que la ruta de seedance-2.5 no está habilitada en el endpoint del backend al que estás llamando. En PixMind es el estado de "Próximamente" mientras se finaliza la conexión del backend. Confirma que estás llamando a la ruta documentada /api-platform/v1/generations con model: "seedance-2.5" (en minúsculas, exacto). Si ambos son correctos y el error persiste, la ruta aún no está abierta en tu cuenta; vigila la página /api-platform/models/seedance-2-5 para la disponibilidad.

¿Qué resoluciones y duraciones puedo solicitar?

Duraciones de hasta 30 segundos en una sola toma; resoluciones de 480p, 720p, 1080p y 4K nativo. Confirma las opciones exactas en el generador en vivo antes de enviar, ya que la ruta conectada puede exponer un subconjunto.

¿Está publicado el precio de la API de Seedance 2.5?

Aún no. Trata cualquier cifra por segundo que veas en otros sitios como una estimación. Consulta el generador en vivo para los créditos actuales en tu duración y resolución elegidas antes de enviar, y estructura tu pipeline para que pueda absorber una actualización de precio sin reescribir la integración.

Empieza a construir con la API de Seedance 2.5

La API de Seedance 2.5 es un contrato estándar de generación de video asíncrona: una llamada de creación, un bucle de sondeo, una descarga. Una vez que tienes una clave con alcance de video, los ejemplos en curl y Python de arriba son todo lo que necesitas para enviar una primera integración. La tabla comparativa y el caso de estudio del pipeline muestran cómo escalar ese contrato desde un clip único hasta un flujo de trabajo de producción repetible que sobrevive a ediciones del cliente, presión de presupuesto y fechas límite.

→ Lee la referencia completa de la ruta de la API de Seedance 2.5, o prueba el modelo en el generador web mientras se finaliza el acceso a la API.

Compara todas las rutas de Seedance

Detalles de endpoint y autenticación verificados contra el backend de la api-platform de PixMind el 2026-07-31. Enlaces de recursos de terceros verificados el 2026-07-31. Los campos de comparación de la API de Kling están marcados como estimación y deben confirmarse contra la documentación en vivo de Kling. El precio de Seedance 2.5 no está publicado y se marca solo como estimación.