Dreamina Seedance 2.5
Tutorial y referencia de la API

Tipos de tarea y restricciones

Seedance 2.5 determina el tipo de tarea según los recursos de entrada y el intención del prompt.

Métodos de configuración: omni_reference_task_type

Referencia multimodal sin especificar subtarea (auto)

{
  "omni_reference_task_type": "auto",
  "ratio": "adaptive",
  "duration": -1
}

Edición de vídeo (explícita)

{
  "omni_reference_task_type": "edit",
  "ratio": "adaptive",
  "duration": -1
  // Vídeo de referencia: 4–30 s
  // Palabras clave del prompt: editar vídeo, añadir, eliminar/quitar, modificar/reemplazar/cambiar
}

Ejemplos de prompt: «Añade algunos animales pequeños a @Video 1». / «Sustituye el personaje de @Video 1 por @Image 1». / «Elimina la música de fondo de @Video 1».

Extensión de vídeo (explícita)

{
  "omni_reference_task_type": "extend",
  "ratio": "adaptive"
  // Palabras clave del prompt: extender hacia adelante/atrás, continuar, continuar la historia
}

Ejemplos de prompt: «Extiende @Video 1 hacia atrás y haz que el personaje de @Image 1 descienda del cielo».

Manejo de errores

• Validación síncrona (al enviar): Cuando omni_reference_task_type = edit o extend, la API valida las restricciones inmediatamente. Si no se cumplen → error inmediato.
• Validación asíncrona (después de arrancar): Cuando omni_reference_task_type = auto o no se proporciona, el modelo determina el tipo real primero, luego valida. Si no se cumplen → error asíncrono.

Código de error por incompatibilidad: InvalidParameter.TaskTypeConstraint
Código de error por discrepancia de tipo: InvalidParameter.TaskTypeMismatch

Generar vídeo coherente de 30 segundos

El límite de duración aumentó de 15 s (Seedance 2.0) a 30 segundos.

Entrada: texto + imagen de referencia

Imagen de referencia: lagarto cornudo del desierto

Prompt (resumen): Anuncio de pomelo con un lagarto cornudo del desierto: 0–3 s, calor del desierto; 3–6 s, el lagarto descubre el pomelo; 6–8 s, lo agarra; 8–11 s, la cáscara se abre y brota el zumo; 11–16 s, el zumo inunda el desierto; 20–23 s, nombre de la marca y eslogan; 23–29 s, el lagarto está de vacaciones en un mar de zumo. Duración total: 30 s.

curl -X POST https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
        {"type": "text", "text": "Estilo publicitario de animación 3D… [PROMPT COMPLETO]"},
        {
            "type": "image_url",
            "image_url": {"url": "https://arkdocs-en.tos-ap-southeast-1.volces.com/images/video-generation/sd-25-30s-input.png"},
            "role": "reference_image"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 30
}'

Hasta 50 recursos de referencia multimodal

Límite aumentado a 50 (30 imágenes + 10 vídeos + 10 audios). Soporta generación con solo referencias de audio (sin necesitar imagen/vídeo).

Entrada: texto + 1 imagen + 6 vídeos de referencia

Imagen 1 · Referencia del sujeto: galleta de fresa

curl -X POST https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
        {"type": "text", "text": "Estilo de anuncio luminoso y colorido con galletas de sabores frutales… [PROMPT COMPLETO]"},
        {"type": "image_url", "image_url": {"url": "...seedance2.5_reference1.png"}, "role": "reference_image"},
        {"type": "video_url", "video_url": {"url": "...seedance2.5_reference2.mp4"}, "role": "reference_video"},
        {"type": "video_url", "video_url": {"url": "...seedance2.5_reference3.mp4"}, "role": "reference_video"},
        {"type": "video_url", "video_url": {"url": "...seedance2.5_reference4.mp4"}, "role": "reference_video"},
        {"type": "video_url", "video_url": {"url": "...seedance2.5_reference5.mp4"}, "role": "reference_video"},
        {"type": "video_url", "video_url": {"url": "...seedance2.5_reference6.mp4"}, "role": "reference_video"},
        {"type": "video_url", "video_url": {"url": "...seedance2.5_reference7.mp4"}, "role": "reference_video"}
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 15,
    "omni_reference_task_type": "reference",
    "output_format": "mov"
}'

Edición de vídeo con control inteligente de relación de aspecto/duración

En las tareas de edición, Seedance 2.5 selecciona el vídeo según la intención del prompt y conserva automáticamente su relación de aspecto y su duración.

Prompt: «Edición de vídeo: elimina a todas las personas de @Video 1 excepto al protagonista».

{
  "model": "dreamina-seedance-2-5-260628",
  "content": [
    {"type": "text", "text": "Edición de vídeo: elimina a todas las personas de @Video1 excepto al protagonista."},
    {"type": "video_url", "video_url": {"url": "...seedance2.5_edit_input.mov"}, "role": "reference_video"}
  ],
  "generate_audio": true,
  "ratio": "adaptive",
  "duration": -1,
  "output_format": "mov"
}

Extensión de vídeo

Selecciona el vídeo a extender según el intención del prompt y mantiene la relación de aspecto consistente. Duración de salida: configurable [4,30] o -1.

Prompt: «Extiende @Video 1. Después de que se abra la ventana, entra en el interior de la galería de arte de @Video 2. Por último, introduce la cámara en el cuadro de @Video 3».

{
  "model": "dreamina-seedance-2-5-260628",
  "content": [
    {"type": "text", "text": "Extiende @Video 1. Después de que se abra la ventana, entra en el interior de la galería de arte de @Video 2. Por último, introduce la cámara en el cuadro de @Video 3."},
    {"type": "video_url", "video_url": {"url": "...r2v_extend_video1_75.mov"}, "role": "reference_video"},
    {"type": "video_url", "video_url": {"url": "...r2v_extend_video2.mp4"}, "role": "reference_video"},
    {"type": "video_url", "video_url": {"url": "...r2v_extend_video3.mp4"}, "role": "reference_video"}
  ],
  "generate_audio": true,
  "ratio": "adaptive",
  "duration": 11,
  "output_format": "mov"
}

Generación desde el primer fotograma o desde el primero y el último

Mantiene automáticamente la relación de aspecto consistente con la imagen del primer fotograma especificada por first_frame.

Primer fotograma

Último fotograma

Prompt: «La chica de la imagen dice “patata” a la cámara, con un movimiento de cámara orbital de 360 grados».

{
  "model": "dreamina-seedance-2-5-260628",
  "content": [
    {"type": "text", "text": "la chica de la imagen dice \"patata\" a la cámara, con un movimiento de cámara orbital de 360 grados"},
    {"type": "image_url", "image_url": {"url": "..."}, "role": "first_frame"},
    {"type": "image_url", "image_url": {"url": "..."}, "role": "last_frame"}
  ],
  "generate_audio": true,
  "ratio": "adaptive",
  "duration": 5
}

Generación multilingüe nativa

Soporta prompt e entrada en: Chino, Inglés, Español, Indonesio, Malayo, Tailandés, Árabe, Portugués, Vietnamita, Japonés, Coreano.

Entrada: texto + imagen de referencia (banda en la playa)

Imagen de referencia

Prompt (resumen): Vídeo musical cinematográfico de hiphop y rap. El vocalista principal lleva un chándal rojo y está en una playa. El rapero dice «Hola» en ocho idiomas, en este orden: inglés → chino → japonés → coreano → portugués → tailandés → español → árabe. Ocho planos con cortes directos y sincronización labial precisa. Sin subtítulos. Duración: 20 segundos.

Resolución

Parámetro resolution. Valor predeterminado: 720p

• 480p — profundidad de color de 8 bits
• 720p — profundidad de color de 8 bits
• 1080p — profundidad de color de 10 bits, H.265/HEVC (puede requerir VLC, mpv o QuickTime para reproducir)

Relación de aspecto

Parámetro ratio. Valor predeterminado: adaptive

Valores: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

Duración

Parámetro duration. Valor predeterminado: -1. Rango: [4, 30] o -1

• -1 en edición: mantiene la duración del vídeo a editar (diferencia máx. 0.4 s)
• -1 en otros: el modelo elige una duración entre [4, 30]

Formato de salida (mov)

Parámetro output_format. Valores: mp4 (predeterminado) o mov

• mp4: Formato de uso general, máxima compatibilidad
• mov: Alta precisión de color para entornos profesionales. Utiliza vídeo H.264, muestreo de crominancia yuv444p y audio PCM. Recomendado para edición y extensión de vídeo

Límites de solicitudes