ByteDance

Seedance 2.0

seedance-2.0-mini

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-mini

Entrada

Creaciones

Ver todas las creaciones

Salida

video

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

Precios

seedance-2.0-mini per second

Especificaciones	480P	720P
Without Reference Videos	$0.0272	$0.0586
With Reference Videos	$0.0172	$0.0358

Descripción general

Seedance 2.0 Mini es la línea ligera de la familia Seedance 2.0 de ByteDance, que se invoca a través de la interfaz unificada de HiAPI.ai y admite generación de video a partir de texto, de imagen y de material de referencia. Puede recibir hasta 9 imágenes de referencia, 3 videos de referencia y 3 audios de referencia, y utiliza la imagen, el movimiento y el timbre como condiciones de generación para producir videos cortos de 4 a 15 segundos con audio, en 480p o 720p. Es adecuado para desarrolladores que necesitan producir en lotes y en ciclos cortos material para redes sociales, previsualizaciones publicitarias y muestras creativas.

Aspectos destacados

Entradas de condición por tres vías: imagen, video y audio de referencia: el material de referencia puede restringir simultáneamente el estilo visual, el modo de movimiento y el audio, lo que reduce la incertidumbre de las descripciones puramente textuales.
Control del inicio y el final del plano con el primer y el último fotograma: al proporcionar imágenes del primer y del último fotograma se puede especificar dónde comienza y dónde termina la imagen, lo que facilita la continuidad entre varios planos.
Generación opcional de audio nativo: de forma predeterminada se genera audio sincronizado con la imagen, aunque también se puede desactivar el canal de audio para producir únicamente según las necesidades visuales.
Duración y relación de aspecto parametrizables: la duración es ajustable entre 4 y 15 segundos y admite relaciones de aspecto como 1:1, 16:9, 9:16 y 21:9, adaptándose a la distribución horizontal y vertical.

Descripción de capacidades

Tres rutas de generación: el prompt de texto, la imagen del primer fotograma o el material de referencia pueden servir como punto de partida de la entrada; se elige el método de generación según el material disponible, sin necesidad de cambiar de interfaz para cada ruta.

El material de referencia restringe la imagen y el movimiento: se admiten hasta 9 imágenes de referencia (contando conjuntamente con el primer y el último fotograma) y hasta 3 videos de referencia con una duración total no superior a 15 segundos; se usan materiales reales en lugar de largas descripciones textuales para fijar el estilo y la acción.

El audio de referencia guía el timbre: se pueden pasar hasta 3 fragmentos de audio de referencia con una duración total no superior a 15 segundos, de modo que el resultado generado se acerque a las muestras dadas en timbre y carácter del audio.

Niveles según resolución y pista de audio: la generación en 480p es más rápida y la 720p equilibra velocidad y calidad de imagen; la generación o no de audio junto con la resolución determinan el nivel de facturación, por lo que se puede elegir la combinación según el presupuesto.

Escenarios de aplicación

Producción masiva de videos cortos para redes sociales: el personal de operaciones genera clips verticales en 9:16 con prompts breves o imágenes de producto y los publica directamente en feeds y cuentas de video corto.
Previsualización de guiones gráficos publicitarios: los equipos creativos producen clips de previsualización de 4 a 15 segundos con imágenes de referencia y el primer y el último fotograma para alinear el ritmo de los planos y la tonalidad visual antes del rodaje definitivo.
Extensión estilística de material de marca: los diseñadores suben imágenes de referencia de marca y videos de referencia breves para generar series de clips con un estilo coherente, destinados a landing pages y espacios de exhibición.
Pruebas rápidas de cortos con efectos de sonido: los creadores de contenido activan la generación de audio y añaden audio de referencia para producir muestras con audio e imagen sincronizados, destinadas a revisión y remontaje.

Limitaciones y recomendaciones de selección

La duración máxima de una salida única es de 15 segundos y la facturación se calcula por segundos de salida, por lo que los contenidos largos deben dividirse en varios fragmentos y unirse después. El primer fotograma y el material de referencia son escenarios mutuamente excluyentes y no pueden combinarse en una misma solicitud; el material de referencia está limitado en conjunto por el número de piezas y la duración total, por lo que los proyectos con mucho material deben procesarse por lotes. La resolución solo admite 480p y 720p; los escenarios que requieran videos finales de alta resolución deben recurrir a las líneas de mayor especificación dentro de la familia.

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-mini

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 3maxLength 20000

Indicación de texto para la generación de video; describe el contenido visual que se desea generar, en formato de cadena de texto.

durationintegerObligatorioPredeterminado: 5min 4max 15

Duración del video en segundos, como número entero, rango de 4 a 15; la facturación es por segundo, cuanto mayor sea la duración, mayor será el costo. Valor predeterminado: 5 segundos.

resolutionstringObligatorioPredeterminado: "720p"

Resolución del video de salida; valor predeterminado 720p; 480p genera más rápido, 720p equilibra velocidad y calidad; la resolución y la presencia o ausencia de audio corresponden a diferentes niveles de facturación.

Opciones:480p720p

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del video; especifica la relación de ancho y alto del video de salida en formato de cadena de texto. Valor predeterminado: 16:9.

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

generate_audiobooleanOpcionalPredeterminado: true

Indica si se genera audio nativo sincronizado con la imagen, con valor booleano. Valor predeterminado: true.

last_frame_urlstringOpcional

URL de la imagen del fotograma final, se usa junto con el fotograma inicial. Los requisitos de la imagen son los mismos que para el fotograma inicial: formatos jpeg/png/webp/bmp/tiff/gif, relación de aspecto 0.4–2.5, lados de 300–6000 px, cada imagen menor de 30 MB.

first_frame_urlstringOpcional

URL de la imagen del fotograma inicial; al proporcionarla se procesa como generación de video a partir de imagen. Formatos compatibles: jpeg/png/webp/bmp/tiff/gif, relación de aspecto 0.4–2.5, lados de ancho y alto de 300–6000 px, cada imagen menor de 30 MB; es un escenario mutuamente excluyente con las imágenes de referencia y los videos de referencia, no se pueden combinar.

reference_audio_urlsarrayOpcionalmaxItems 3

Lista de URL de audios de referencia, máximo 3 fragmentos y una duración total no superior a 15 segundos; cada fragmento en formato wav/mp3, duración de 2 a 15 segundos, menor de 15 MB.

Array [ string ]

reference_image_urlsarrayOpcionalmaxItems 9

Lista de URL de imágenes de referencia; la suma del número de imágenes de la lista y el número de fotogramas inicial y final no debe superar las 9 imágenes; cada imagen admite formatos jpeg/png/webp/bmp/tiff/gif, relación de aspecto 0.4–2.5, lados de 300–6000 px, cada imagen menor de 30 MB. Es un escenario mutuamente excluyente con el fotograma inicial y los videos de referencia, no se pueden combinar.

Array [ string ]

reference_video_urlsarrayOpcionalmaxItems 3

Lista de URL de videos de referencia, máximo 3 y una duración total no superior a 15 segundos; cada uno en formato mp4/mov, resolución 480p/720p, duración de 2 a 15 segundos, relación de aspecto 0.4–2.5, lados de 300–6000 px, píxeles totales 409600–927408, tasa de fotogramas 24–60, cada video menor de 50 MB.

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

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-mini",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

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-mini",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }),
});
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-mini",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True
        }
    },
)
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"
    }
  }
}