ByteDance

Seedance 2.5

seedance-2.5/image-to-video

Modelo de generación conjunta de audio y vídeo de ByteDance Seed, compatible con clips continuos de hasta 30 segundos y 4K, y con control preciso de la imagen mediante referencias multimodales y edición a nivel de marca de tiempo

seedance-2.5/image-to-video seedance-2.5/reference-to-video seedance-2.5/text-to-video

Probar seedance-2.5/image-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

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

Precios

seedance-2.5/image-to-video per second

Especificaciones	Precio unitario
720P	$0.204
1080P	$0.516

Descripción general

La línea de generación de video a partir de imagen de Seedance 2.5 está dirigida a desarrolladores que necesitan un control preciso de la imagen: parte de una imagen de primer fotograma, con la opción de restringir el punto final mediante un fotograma final, y describe con un prompt el movimiento, la cámara y la escena para generar un video coherente de 4 a 30 segundos. El modelo produce diálogos sincronizados, efectos de sonido y sonido ambiente al mismo tiempo que genera la imagen, y admite salidas en 720p y 1080p, con dos formatos de contenedor: mp4 y mov. Es adecuado para quienes ya disponen de material de imagen fija y necesitan ampliarlo a videos cortos para presentaciones de productos, previsualización de planos publicitarios y producción de contenido seriado.

Características principales

Restricción bidireccional del plano mediante fotogramas inicial y final: se proporciona el primer fotograma y, opcionalmente, se especifica el fotograma final, de modo que tanto el inicio como el final del video generado se apoyan en material existente, lo que reduce las regeneraciones repetidas.
Imagen y audio generados de una sola vez: de forma predeterminada se producen simultáneamente diálogos, efectos de sonido y audio de fondo, sin necesidad de doblaje y sincronización por separado.
Prompts en once idiomas: las instrucciones de movimiento, cámara, escena y audio pueden escribirse en varios idiomas, lo que facilita la colaboración de equipos multilingües.
Resolución y contenedor seleccionables: admite 720p y 1080p, mp4 y mov; el formato mov facilita la integración en flujos de posproducción profesionales.

Descripción de capacidades

Generación de video a partir del primer fotograma: genera video a partir de una imagen de primer fotograma en formatos como jpeg, png o webp; la relación de aspecto de la imagen se adapta a la del primer fotograma, lo que resulta adecuado para continuar creaciones a partir de imágenes fijas ya finalizadas.

Control del punto final mediante fotograma final: se puede añadir una imagen de fotograma final para restringir la imagen de cierre del video; si la relación de aspecto no coincide, se recorta centrada para ajustarla al primer fotograma, lo que facilita planos con un cierre puntual.

Generación de audio sincronizado: de forma predeterminada se generan diálogos, efectos de sonido y audio de fondo sincronizados con la imagen; también se puede desactivar para obtener únicamente material visual y procesarlo en posproducción.

Parámetros de duración y calidad de imagen: la duración se ajusta en segundos enteros de 4 a 30 y se factura según la duración solicitada; la resolución se elige entre 720p y 1080p, y la salida es mp4 o mov.

Complemento de información mediante conexión a internet: se puede activar la búsqueda en línea para que la información de actualidad mencionada en el prompt se tenga en cuenta durante la generación.

Casos de uso

Equipos de comercio electrónico y productos: imágenes de producto finalizadas: generar un video corto de presentación tomando una imagen fija del producto como primer fotograma; la imagen y el audio se producen de forma sincronizada y pueden usarse directamente en páginas de detalle o en material publicitario.
Equipos de creatividad publicitaria: fotogramas clave del guion gráfico: ampliar los fotogramas clave del guion gráfico en clips con movimiento de cámara y efectos de sonido para presentaciones de propuestas y previsualización previa al rodaje.
Operación de contenido de marca: imágenes finalizadas de personajes y escenas: extender imágenes ya finalizadas de personajes o escenas en una serie de videos cortos, manteniendo la coherencia de apariencia y produciendo contenido para redes sociales en lote.
Posproducción: complemento de planos con fotogramas inicial y final: generar el proceso intermedio a partir de las imágenes de inicio y fin dadas, para empalmar material o completar planos de transición.

Limitaciones y recomendaciones de selección

Cada generación admite como máximo 30 segundos; los contenidos más largos deben dividirse en varios fragmentos y generarse por separado. La plausibilidad física de acciones complejas y la estabilidad de las interacciones entre múltiples sujetos siguen siendo puntos débiles conocidos; en planos con movimientos amplios o muchas personas se recomienda validar primero con una muestra pequeña. Cuando se proporcionan a la vez el primer y el último fotograma, no se pueden añadir imágenes o audio de referencia; si se necesitan múltiples restricciones de referencia, debe usarse la línea de generación de video a partir de referencias. Para necesidades ligeras, de un solo plano y con pocos requisitos de controlabilidad, se puede optar por una línea de generación de video a partir de texto más simplificada.

Preguntas frecuentes

Ver todas las preguntas →

¿Se requiere subir tanto el primer fotograma como el último para la generación de video a partir de imagen con Seedance 2.5?

No es necesario. En el modo de primer fotograma/primer y último fotograma, si solo se sube first_frame_url, el modelo extiende naturalmente las imágenes posteriores a partir del primer fotograma; si se necesita controlar el estado final de la toma, se proporciona además last_frame_url. El último fotograma no puede usarse de forma independiente. También se puede optar por usar reference_image_urls o reference_audio_urls como modo de referencia, sin pasar los fotogramas de los extremos.
¿Se pueden mezclar el primer fotograma, el primer y último fotograma y múltiples materiales de referencia en una sola solicitud?

Actualmente, HiAPI Playground los trata como dos modos de entrada: el modo de primer fotograma/primer y último fotograma, o el modo de referencia con reference_image_urls y reference_audio_urls. Para evitar que las señales de control entren en conflicto, conserve un solo modo en cada solicitud; cuando necesite un video de referencia para guiar la acción o el movimiento de cámara, utilice en su lugar el endpoint independiente seedance-2.5/reference-to-video.
¿Qué duraciones y resoluciones admite la generación de video a partir de imagen de Seedance 2.5?

El contrato de solicitud actual admite duraciones enteras de 4–30 segundos, así como 720p y 1080p. El aspect_ratio de salida es fijo en adaptive y sigue la relación de aspecto del primer fotograma. Los cuatro casos de la página son todos en 720p, de los cuales tres son de 4 segundos y uno de 5 segundos; los 30 segundos están dentro del rango admitido por la interfaz, pero la página aún no cuenta con un caso correspondiente.
¿Cómo se factura Seedance 2.5 de imagen a video?

Se factura según la duración y la resolución de salida; 720p y 1080p usan tarifas por segundo diferentes; el importe exacto se rige por el precio en tiempo real de la página del modelo y el registro de tareas.

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.5/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para seedance-2.5/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 10000

Proporciona instrucciones de generación relacionadas con la acción, la cámara, la escena y el audio; admite varios idiomas de prompt.

durationintegerOpcionalPredeterminado: 5min 4max 30

Duración del vídeo de salida en segundos; introduce un número entero entre 4 y 30, por defecto 5. HiAPI factura según la duración solicitada.

watermarkbooleanOpcionalPredeterminado: false

Indica si se añade una marca de agua de generación por IA en la esquina inferior derecha; por defecto false.

resolutionstringOpcionalPredeterminado: "720p"

Resolución del vídeo de salida; admite 720p y 1080p, por defecto 720p.

Opciones:720p1080p

web_searchbooleanOpcionalPredeterminado: false

Indica si se permite al modelo consultar en línea información en tiempo real mencionada en el prompt; por defecto false.

aspect_ratiostringOpcionalPredeterminado: "adaptive"

Relación de aspecto de la imagen de salida; en la generación de vídeo a partir de imagen se usa adaptive para que el vídeo siga el primer fotograma, por defecto adaptive.

Opciones:adaptive

output_formatstringOpcionalPredeterminado: "mp4"

Formato de archivo del vídeo de salida; mp4 es el valor predeterminado por su mayor compatibilidad y mov está orientado a la posproducción profesional, por defecto mp4.

Opciones:mp4mov

generate_audiobooleanOpcionalPredeterminado: true

Indica si se generan diálogos, efectos de sonido y audio de fondo sincronizados; por defecto true.

last_frame_urlstringOpcional

Opcional; especifica la imagen del fotograma final. Puede ser una URL de imagen, una URL de datos o un ID de material; las restricciones de archivo son las mismas que para el primer fotograma. Si la relación de aspecto difiere de la del primer fotograma, se recorta centrada para alinearla con este.

first_frame_urlstringOpcional

Imagen del primer fotograma; puede ser una URL de imagen, una URL de datos o un ID de material. Admite varios formatos de imagen comunes, con un tamaño no superior a 30 MB, entre 300 y 6000 píxeles por lado y una relación de aspecto de 0.4 a 2.5. Es obligatorio cuando se proporciona last_frame_url.

reference_audio_urlsarrayOpcionalmaxItems 10

Matriz de URL de audio de referencia, hasta 10; admite wav y mp3, con un máximo de 15 MB por archivo, una duración de 2 a 30 segundos y una duración total no superior a 30 segundos.

Array [ string ]

reference_image_urlsarrayOpcionalmaxItems 30

Matriz de URL de imágenes de referencia, hasta 30; admite varios formatos de imagen comunes, con un máximo de 30 MB por imagen, entre 300 y 6000 píxeles por lado y una relación de aspecto de 0.4 a 2.5.

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.5/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "watermark": false,
    "resolution": "720p",
    "web_search": false,
    "aspect_ratio": "adaptive",
    "output_format": "mp4",
    "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.5/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "watermark": false,
      "resolution": "720p",
      "web_search": false,
      "aspect_ratio": "adaptive",
      "output_format": "mp4",
      "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.5/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "watermark": False,
          "resolution": "720p",
          "web_search": False,
          "aspect_ratio": "adaptive",
          "output_format": "mp4",
          "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"
    }
  }
}