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
- 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
-1para automático; por defecto 5. - resolution:
480po720p; por defecto480p. - aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, o
adaptivepara seguir los materiales de referencia; por defectoadaptive. - omni_reference_task_type: fijo en
reference(valor por defecto, se puede omitir). - output_format:
mp4(por defecto) omov; generate_audio: por defectotrue, 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 →-
Guía de uso
Guía de integración de Seedance 2.5 Flash para imagen a video: primer fotograma, último fotograma y facturación por segundo
Hacer que una imagen se mueva: parámetros, precios y causas habituales de fallo
-
Guía de uso
Guía de integración de texto a vídeo de Seedance 2.5 Flash: parámetros, facturación por segundo y prácticas de ingeniería
De una solicitud a la puesta en producción estable: cómo configurar los parámetros y cómo calcular el coste
-
Guía de uso
Guía de inicio de kling-image-4.0: puntos clave de integración de la API de generación de imágenes y control de costes
Decisiones de integración y lista de verificación práctica para desarrolladores