HiAPI
Blog

Guía de uso

Guía de integración de Seedance 2.5 Flash para generar video a partir de materiales de referencia: imágenes de referencia, audio de referencia y reglas de facturación

Nov 17, 2026
Stacked sheets receding into shallow depth of field, cream and graphite with one terracotta sheet as accent.
Modelo
seedance-2.5-flash
En esta página

Qué hace este modelo

seedance-2.5-flash/reference-to-video es el modelo de video impulsado por materiales de referencia de ByteDance. Le proporcionas imágenes y audios de referencia, los referencias en orden en el prompt con @image1 y @audio1, y el modelo genera un nuevo video a partir de ellos. Las imágenes de referencia determinan el aspecto de las personas, los productos o las escenas; el audio de referencia aporta el ritmo, la música o la locución.

Restricciones de los materiales de referencia

  • Imágenes de referencia: máximo 10, formatos jpeg, png, webp, bmp, tiff y gif, menos de 30 MB por imagen, entre 300 y 6000 píxeles por lado, relación de aspecto entre 0.4 y 2.5; no se admiten SVG, HEIC ni HEIF.
  • Audios de referencia: máximo 5, en wav o mp3, menos de 15 MB, entre 2 y 30 segundos por segmento y no más de 30 segundos en total; se puede enviar solo audio, sin imágenes.

Debe proporcionarse al menos uno de los dos tipos de material; de lo contrario, la solicitud no es válida.

Reglas de facturación

Esta vía factura por los segundos del video de salida; las imágenes y los audios de referencia no cuentan para los segundos facturables:

  • 480p: $0.0679/segundo, un video de 5 segundos cuesta aproximadamente $0.34.
  • 720p: $0.1525/segundo, un video de 5 segundos cuesta aproximadamente $0.76.

Si se indica una duración entera entre 4 y 30, se factura según los segundos indicados; si se indica -1 (automático), se redondea la duración real del video y se factura un mínimo de 4 segundos. Para controlar el presupuesto, indica un número fijo de segundos.

Parámetros de la solicitud

  • prompt (obligatorio): explica cómo usar los materiales, referenciándolos en orden con @image1, @audio1; máximo 5000 caracteres.
  • reference_image_urls / reference_audio_urls: arreglos de URL de las imágenes y los audios de referencia.
  • duration: entero entre 4 y 30, o -1 para automático; por defecto 5.
  • resolution: 480p o 720p; por defecto 480p.
  • aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, o adaptive para seguir los materiales de referencia; por defecto adaptive.
  • omni_reference_task_type: fijo en reference (valor por defecto, se puede omitir).
  • output_format: mp4 (por defecto) o mov; generate_audio: por defecto true, genera diálogos, efectos de sonido y sonido de fondo sincronizados.

Cómo escribir el prompt

Primero numera los materiales en el orden en que aparecen y luego explica uno por uno qué función cumple cada material y cómo debe quedar la imagen final. Por ejemplo:

El producto de @image1 se coloca sobre una mesa de madera y gira lentamente para mostrarse, el fondo es la ventana al amanecer de @image2,
la cámara se acerca lentamente de un plano medio a un primer plano, el ritmo de la imagen sigue el pulso de @audio1 y se mantiene el brillo metálico del producto.

Cuando haya varias imágenes de referencia, especificar cuál es el sujeto y cuál es la escena o el estilo es mucho más estable que limitarse a escribir "usa estas imágenes como referencia". Si usas audio de referencia, indica con qué parte del audio deben coincidir las acciones de la imagen.

Preguntas frecuentes

  • La solicitud se rechaza por falta de materiales: debe haber al menos una imagen o un audio de referencia.
  • No se puede subir la imagen de referencia: comprueba primero si el formato está en la lista admitida, si los píxeles por lado están entre 300 y 6000 y si la relación de aspecto está entre 0.4 y 2.5.
  • Se rechaza el audio: cada segmento debe durar entre 2 y 30 segundos, pesar menos de 15 MB y el total de varios segmentos no debe superar los 30 segundos.
  • El costo no coincide con lo esperado: comprueba si usaste la duración automática -1; la duración automática se factura según los segundos reales del video.

Recomendaciones de lanzamiento

Primero ejecuta una solicitud con una imagen de referencia, 5 segundos y 480p para confirmar la cadena y el criterio de cobro; luego ejecuta otra con audio de referencia o varias imágenes de referencia y comprueba si la imagen usa los materiales según la numeración del prompt. Guarda los registros de estas dos solicitudes como línea base para tener una referencia cuando más adelante cambies el prompt o los materiales. Los parámetros y los precios se rigen por las indicaciones vigentes en la página del modelo.

Artículos relacionados

Ver todos los artículos →

Empieza a crear con artefactos de IA persistentes

Consigue tu API key y llama a modelos de imagen, vídeo y audio a través de una única API basada en tasks.

Leer la documentación de la API