ByteDance

Seedance 2.0

seedance-2.0

Modelo de generación de video multimodal de ByteDance que admite generación de video a partir de texto, imagen y referencia, y puede producir cortometrajes cinematográficos de múltiples tomas con audio nativo sincronizado

Ruta

default ext

seedance-2.0 seedance-2.0-fast seedance-2.0-mini

Probar seedance-2.0

Entrada

Creaciones

Ver todas las creaciones

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

seedance-2.0 per second

Especificaciones	480P	720P	1080P	4K
Without Reference Videos	$0.136	$0.293	$0.729	$1.486
With Reference Videos	$0.082	$0.179	$0.443	$0.915

Descripción general

Seedance 2.0 es un modelo multimodal de generación de vídeo lanzado por ByteDance. Admite entradas combinadas de texto, imágenes, vídeos de referencia y audio de referencia, y genera en una sola pasada vídeos de 4 a 15 segundos con audio nativo y hasta 4K. El modelo pone énfasis en la narrativa multicámara y la consistencia de personajes; los fotogramas inicial y final y los materiales de referencia pueden usarse para condicionar el desarrollo de la imagen. Es adecuado para desarrolladores que necesitan producir rápidamente anuncios cortos, vídeos cortos para redes sociales y previsualizaciones narrativas, y se invoca a través de la interfaz unificada de HiAPI.ai con facturación según los segundos de salida.

Puntos clave

Generación impulsada por materiales multimodales: permite combinar texto, hasta 9 imágenes de referencia, 3 vídeos de referencia y 3 audios de referencia, usando materiales reales para condicionar el estilo visual, el movimiento y el sonido.
Control del inicio y el final del plano mediante fotogramas inicial y final: al especificar las imágenes del primer y último fotograma, el vídeo generado comienza en la imagen indicada y termina en la imagen indicada, lo que facilita la continuidad entre planos y las transiciones precisas.
Generación sincronizada de audio nativo: genera por defecto audio sincronizado con la imagen y permite superponer audio de referencia para guiar el timbre y el ritmo, reduciendo el trabajo de alineación audio-imagen en posproducción.
Hasta 4K y formato adaptable: la resolución abarca de 480p a 4k, y el formato admite de 1:1 a 21:9, además de adaptive para seguir la proporción de la imagen de origen, lo que permite adaptarse a múltiples canales con una sola llamada.

Descripción de capacidades

Tres modos de generación: admite texto a vídeo, imagen a vídeo y vídeo de referencia a vídeo; la misma interfaz cambia según la combinación de materiales, lo que facilita cubrir desde el concepto hasta el resultado final en un único flujo de trabajo.

Condicionamiento con múltiples materiales de referencia: se pueden enviar simultáneamente imágenes, vídeos y audios de referencia; las imágenes de referencia y los fotogramas inicial y final suman en total un máximo de 9, y los vídeos y audios de referencia no superan los 3 fragmentos cada uno ni los 15 segundos de duración total cada uno.

Control de duración y resolución: la duración puede especificarse entre 4 y 15 segundos, y la resolución puede ser 480p, 720p, 1080p o 4k. La facturación se realiza según los segundos de salida, lo que facilita controlar los costes según las especificaciones de difusión.

Devolución del último fotograma: al activar return_last_frame se devuelve el último fotograma del vídeo generado, que puede usarse directamente como fotograma inicial de entrada del siguiente fragmento para encadenar varias generaciones.

Mejora con búsqueda en internet: el interruptor web_search permite habilitar la búsqueda en internet durante la generación para añadir información actualizada a la indicación (prompt), adecuado para contenidos creativos que dependen de eventos o noticias actuales.

Casos de uso

Equipos de publicidad y marca: guion de texto más imágenes de referencia: generar rápidamente vídeos de marca multicámara y producir vídeos de 1080p o 4k con audio para difusión en redes sociales y materiales del sitio web.
Creadores de vídeos narrativos cortos: fotogramas inicial y final más imágenes de referencia de personajes: fijar el inicio y el final del plano con los fotogramas inicial y final y mantener la consistencia de los personajes con las imágenes de referencia para producir fragmentos de storyboard coherentes, destinados a microseries o contenidos narrativos.
Previsualización creativa: vídeo de referencia más audio de referencia: guiar el estilo y el ritmo con fragmentos y voces existentes para generar vídeos de previsualización dinámica, de modo que directores y clientes confirmen la dirección antes de la producción oficial.
Integración para desarrolladores: producción por lotes con facturación por segundo: enviar tareas de generación por lotes a través de la interfaz unificada de HiAPI.ai, controlar el presupuesto según los segundos de salida e integrarse en la cadena de producción de contenidos.

Limitaciones y recomendaciones de selección

La duración máxima de una sola generación es de 15 segundos, por lo que los vídeos largos deben generarse por fragmentos y unirse después; la cantidad de materiales de referencia es limitada: las imágenes de referencia y los fotogramas inicial y final suman en total un máximo de 9, y los vídeos y audios de referencia no superan los 3 fragmentos cada uno ni los 15 segundos de duración total cada uno, por lo que los proyectos complejos deben dividirse. La devolución del último fotograma requiere activar el interruptor y depende de que también se proporcione el fotograma inicial. Si la necesidad es de planos continuos muy largos o de flujos de posproducción tradicionales con control preciso fotograma a fotograma, conviene evaluar soluciones específicas de edición y composición; cuando se requiera una pieza final más larga, es recomendable generar por fragmentos y editar después.

Novedades

Ver el registro de cambios →

Nuevo modelo Ya está disponible el modelo de generación de video seedance-2.0-fast Nov 3, 2026
Nuevo modelo Nuevo modelo disponible: seedance-2.0-mini Nov 3, 2026
Cambio de ruta La ruta ext de seedance-2.0 ahora solo muestra las opciones 720p, 1080p... realmente compatibles Aug 10, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Qué tipo de modelo de video es Seedance 2.0?

Se centra en el Prompt y también puede incorporar el primer y último fotograma o imágenes, videos y audios de referencia; los distintos métodos de control deben combinarse según el contrato de parámetros vigente.
¿Qué especificaciones de salida admite Seedance 2.0?

Admite de 4 a 15 segundos, resoluciones que incluyen 480p, 720p, 1080p y 4k, y relaciones de aspecto que incluyen 1:1, 4:3, 3:4, 16:9, 9:16, 21:9 y adaptive.
¿Se puede generar voz o usar referencias de audio?

Referencias opcionales de imagen, vídeo y audio; admite generación de audio
¿Cómo se factura Seedance 2.0?

Se factura según la duración de salida y el nivel en tiempo real; las diferencias por resolución, modo u opciones de sonido se rigen por el precio de la página y el registro de la tarea.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: seedance-2.0

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para seedance-2.0 y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 3maxLength 20000

Texto de indicación para la generación de video que determina la descripción visual y el estilo del contenido generado.

durationintegerOpcionalPredeterminado: 5min 4max 15

Duración del video generado, en segundos; por defecto, 5 segundos.

resolutionstringOpcionalPredeterminado: "720p"

Resolución del video generado; por defecto, 720p; 4k permite obtener detalles en ultra alta definición.

Opciones:480p720p1080p4k

web_searchbooleanOpcional

Indica si se habilita la búsqueda web durante la generación para complementar información.

aspect_ratiostringObligatorioPredeterminado: "16:9"

Relación de aspecto del video generado; por defecto, 16:9; cuando el valor es adaptive, la generación de video a partir de imagen sigue la proporción de la imagen de origen, mientras que la generación de video a partir de texto vuelve a la proporción predeterminada.

Opciones:1:14:33:416:99:1621:9adaptive

generate_audiobooleanOpcionalPredeterminado: true

Indica si se genera audio de forma sincronizada cuando el modelo lo admite; habilitado por defecto (true).

last_frame_urlstringOpcional

URL de la imagen del fotograma final o ID de recurso asset://, usado para especificar la imagen final del video.

first_frame_urlstringOpcional

URL de la imagen del fotograma inicial o ID de recurso asset://; este parámetro es obligatorio cuando se proporciona last_frame_url.

return_last_framebooleanOpcionalPredeterminado: false

Indica si se devuelve el fotograma final del video generado; por defecto, false.

reference_audio_urlsarrayOpcionalmaxItems 3

Arreglo de direcciones de audio de referencia; cada elemento es una URL de audio o un ID de recurso asset://; máximo 3 segmentos y una duración total no superior a 15 segundos.

Array [ string ]

reference_image_urlsarrayOpcionalmaxItems 9

Arreglo de direcciones de imágenes de referencia; cada elemento es una URL de imagen o un ID de recurso asset://; junto con las imágenes del fotograma inicial y final, no debe superar las 9 imágenes en total.

Array [ string ]

reference_video_urlsarrayOpcionalmaxItems 3

Arreglo de direcciones de videos de referencia; cada elemento es una URL de video o un ID de recurso asset://; máximo 3 videos, cada uno con una duración de 2 a 15 segundos y una duración total no superior a 15 segundos.

Array [ string ]

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

modelstringObligatorio

Valor fijo actual: seedance-2.0

routestringOpcional

Valor fijo actual: ext

inputobjectObligatorio

Objeto de parámetros de negocio para seedance-2.0 y la ruta ext; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 3maxLength 20000

Text prompt used for video generation.

durationintegerOpcionalPredeterminado: 5min 4max 15

Video duration in seconds.

resolutionstringOpcionalPredeterminado: "720p"

Video resolution on the ext route: 720p, 1080p, or 4k.

Opciones:720p1080p4k

web_searchbooleanOpcional

Whether to enable web search for generation.

aspect_ratiostringObligatorioPredeterminado: "16:9"

Video aspect ratio. adaptive follows the source image ratio (image-to-video); for text-to-video it falls back to the default.

Opciones:1:14:33:416:99:1621:9adaptive

generate_audiobooleanOpcionalPredeterminado: true

Whether to generate synchronized audio when supported.

last_frame_urlstringOpcional

Last-frame image URL or asset:// asset id.

first_frame_urlstringOpcional

First-frame image URL or asset:// asset id.

return_last_framebooleanOpcionalPredeterminado: false

Whether to return the last frame of the generated video.

reference_audio_urlsarrayOpcionalmaxItems 3

Reference audio URLs or asset:// asset ids. Up to 3 audio clips, total duration no more than 15 seconds.

Array [ string ]

reference_image_urlsarrayOpcionalmaxItems 9

Reference image URLs or asset:// asset ids. Combined count with first/last frame images should not exceed 9.

Array [ string ]

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.0",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "return_last_frame": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.0",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "return_last_frame": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedance-2.0",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True,
          "return_last_frame": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.0@ext",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "return_last_frame": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.0@ext",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "return_last_frame": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedance-2.0@ext",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True,
          "return_last_frame": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}