Generación de Videos con Seedance
Genera videos de baile y movimiento con IA a través de la API Seedance (ByteDance) de AceDataCloud.
Configuración: Consulta autenticación para la configuración del token.
Inicio Rápido
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "callback_url": "https://api.acedata.cloud/health"}'
Asíncrono: Consulta polling de tareas asíncronas. Realiza polling mediante
POST /seedance/taskscon{"id": "..."}. Esto devuelve un ID de tarea inmediatamente. Realiza polling para obtener el resultado:
curl -X POST https://api.acedata.cloud/seedance/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id from above>"}'
Modelos
Seedance 2.0 (generación actual — referencia multimodal)
La serie 2.0 añade entradas de referencia multimodal: referencias de imagen de persona real/personaje, audio de referencia y video de referencia (consulta los flujos de trabajo a continuación).
| Modelo | Mejor para | Resolución máxima |
|---|---|---|
doubao-seedance-2-0-260128 | Máxima calidad, referencia de persona real/personaje, salida 4k | 4k |
doubao-seedance-2-0-fast-260128 | Generación 2.0 más rápida | 720p |
doubao-seedance-2-0-mini-260615 | Ligero / 2.0 más rentable | 720p |
Seedance 1.x
| Modelo | Tipo | Mejor para |
|---|---|---|
doubao-seedance-1-5-pro-251215 | Texto+Imagen a Video | 1.5 emblemático, soporte de audio |
doubao-seedance-1-0-pro-250528 | Texto+Imagen a Video | Uso general, calidad confiable |
doubao-seedance-1-0-pro-fast-251015 | Texto+Imagen a Video | Generación Pro más rápida |
doubao-seedance-1-0-lite-t2v-250428 | Solo texto a video | Texto a video ligero |
doubao-seedance-1-0-lite-i2v-250428 | Solo imagen a video | Imagen a video ligero |
Flujos de Trabajo
1. Texto a Video
Pasa un elemento de contenido de texto en el arreglo content.
POST /seedance/videos
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. Imagen a Video
Incluye un elemento de contenido de imagen (con un role opcional) junto al texto.
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "the person starts dancing gracefully"},
{
"type": "image_url",
"role": "first_frame",
"image_url": {"url": "https://example.com/dancer.jpg"}
}
],
"resolution": "720p",
"duration": 5
}
Roles de imagen:
first_frame— la imagen se usa como el fotograma iniciallast_frame— la imagen se usa como el fotograma finalreference_image— la imagen se usa como referencia de estilo / sujeto / persona real (Seedance 2.0 mantiene consistente a la persona o personaje referenciado)
Medios de referencia (solo Seedance 2.0):
audio_url— audio de referencia para timbre de voz / música de fondo (sinrole)video_url— video de referencia para sujeto, movimiento de cámara, movimiento o estilo general (sinrole)
3. Primer fotograma + Último fotograma
Proporciona tanto una imagen de inicio como de fin:
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "smooth transition between two scenes"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
]
}
4. Referencia de persona real / personaje (Seedance 2.0)
Los modelos Seedance 2.0 (doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615) pueden mantener a una persona o personaje específico consistente en una escena completamente nueva. Pasa una o más fotos como elementos image_url con role: "reference_image" — el modelo preserva la apariencia de ese sujeto. Se aceptan hasta 9 imágenes de referencia.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
],
"resolution": "1080p",
"duration": 8
}
5. Audio / video de referencia (Seedance 2.0)
Los modelos 2.0 también aceptan audio de referencia (timbre de voz, música de fondo) y video de referencia (contenido del sujeto, movimiento de cámara, movimiento, estilo general). Añade elementos de contenido audio_url y/o video_url. Límites: hasta 3 referencias de audio y 3 de video por solicitud.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "a singer performing on stage, matching the reference voice and motion"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
{"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}},
{"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
],
"generate_audio": true
}
Parámetros
| Parámetro | Valores | Descripción |
|---|---|---|
model | consulta la tabla de Modelos | Modelo a utilizar (obligatorio) |
content | arreglo | Elementos de entrada: text, image_url, audio_url (2.0), video_url (2.0) (obligatorio) |
resolution | "480p", "720p", "1080p", "4k" | Resolución de salida. 4k es solo para doubao-seedance-2-0-260128 (estándar); 2-0-fast / 2-0-mini máximo 720p (predeterminado: 720p para pro/2.0, 480p para lite) |
ratio | "16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive" | Relación de aspecto (predeterminado: 16:9) |
duration | 2 – 15 | Duración en segundos (Seedance 2.0 soporta 4–15) |
frames | 29–361 (debe satisfacer 25+4n) | Número de fotogramas — mutuamente excluyente con duration |
seed | -1 a 4294967295 | Semilla para resultados reproducibles (-1 = aleatorio) |
generate_audio | true / false | Generar audio (soportado por doubao-seedance-1-5-pro-251215 y la serie doubao-seedance-2-0; otros modelos lo ignoran) |
camerafixed | true / false | Fijar la posición de la cámara durante la generación |
watermark | true / false | Añadir una marca de agua al video generado |
return_last_frame | true / false | Devolver el último fotograma del video generado |
service_tier | "default", "flex" | Nivel de procesamiento (predeterminado: default) |
execution_expires_after | número | Umbral de tiempo de espera de la tarea en segundos |
Sintaxis de Parámetros en Línea
También puedes incrustar parámetros de generación directamente en el prompt de texto usando la sintaxis --param valor:
A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
Parámetros en línea soportados: --rs (resolución), --rt (relación de aspecto), --dur (duración), --frames, --fps (solo 24), --seed, --cf (camera_fixed), --wm (marca de agua).
Advertencias
- Los nombres de los modelos usan la convención
doubao-*(ej.doubao-seedance-1-0-pro-250528) — los nombres cortos antiguos comoseedance-1.0no son válidos - El arreglo
contentreemplaza los antiguos camposprompt+image_url; usa siemprecontent - Los escenarios de imagen y texto son mutuamente excluyentes por elemento de contenido — cada elemento tiene
textoimage_url, no ambos first_frameylast_framepueden combinarse en una sola solicitud, peroreference_imagees mutuamente excluyente confirst_frame/last_frame— no mezcles una imagen de referencia con fotogramas de inicio/fingenerate_audio: truees soportado pordoubao-seedance-1-5-pro-251215y la seriedoubao-seedance-2-0; otros modelos ignoran este campo- Los modelos Lite se dividen:
*-lite-t2v-*solo acepta texto,*-lite-i2v-*solo acepta imagen a video - Los elementos de referencia
audio_urlyvideo_urlson usados solo por la serie Seedance 2.0 - Las opciones de resolución son
480p,720p,1080py4k(4kes solo paradoubao-seedance-2-0-260128;2-0-fast/2-0-minimáximo720p) — no hay 360p ni 540p - Los valores de
service_tierson"default"y"flex"(no "standard"/"premium") - El rango de duración es 2–15 segundos (Seedance 2.0 soporta 4–15) — los valores fuera de este rango fallarán
- Los estados de tarea usan
"succeeded"(no "completed") — verifica este valor al hacer polling
MCP:
pip install mcp-seedance| Alojado:https://seedance.mcp.acedata.cloud/mcp| Consulta todos los servidores MCP