Seedance 2.5 Flash API
Referencia completa de la API de los modelos de generación de vídeo Seedance 2.5 Flash de ByteDance.
Variantes del modelo
Esta API admite tres variantes del modelo:
Comparación rápida
Relaciones de aspecto admitidas
Las variantes de generación a partir de texto y de referencias admiten las siguientes relaciones de aspecto:
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
La variante de generación a partir de una imagen no admite el parámetro aspect_ratio.
Resoluciones disponibles
Seedance 2.5 Flash Text to Video
Punto de conexión
POST /api/v1/video/task
Parámetros de la solicitud
Obligatorios
Opcionales
Ejemplo de solicitud
javascript
Seedance 2.5 Flash Image to Video
Parámetros de la solicitud
Obligatorios
Opcionales
No incluyas
aspect_ratioen las solicitudes de generación de vídeo a partir de una imagen. Este modelo no admite ese parámetro.
Ejemplo de solicitud
javascript
Seedance 2.5 Flash Reference to Video
Parámetros de la solicitud
Obligatorios
Medios de referencia
Todos los medios de referencia son opcionales. Se admiten solicitudes con solo imágenes, solo vídeos, solo audio o sin ningún medio de referencia. Para generar vídeos sin referencias se recomienda la variante Text to Video.
Marcadores de referencia @ (AT)
La función de referencias @ (AT) vincula los medios de referencia con la instrucción mediante marcadores numerados del tipo <<<...>>>. La numeración empieza en 1 para cada tipo de medio y sigue el orden de la lista correspondiente:
Por ejemplo, si la primera imagen sirve de referencia para un personaje y la segunda para una escena, usa <<<image_1>>> para el personaje y <<<image_2>>> para la escena en prompt. Cada marcador debe apuntar a un elemento existente en la lista correspondiente.
Opcionales
Ejemplo de solicitud
javascript
Ejemplo de solicitud de generación de vídeo con referencias @ (AT)
javascript
Límites de los medios
Estos límites se aplican a las imágenes del primer y del último fotograma y a los medios de referencia de los modelos descritos en esta página.
Los clips de audio y los vídeos de referencia tienen límites de duración independientes de 30 segundos en total para cada tipo. Las cantidades máximas también son independientes: hasta 10 imágenes, 5 vídeos y 5 clips de audio.
Todos los modelos requieren resolution y duration, sin valores predeterminados. Si se omite aspect_ratio, las variantes de generación a partir de texto y de referencias usan 16:9. El sonido está activado de forma predeterminada (true). Usa false para generar un vídeo sin sonido.
Formato de respuesta
Respuesta inicial
Todos los modelos devuelven un task_id para consultar periódicamente el estado de la tarea:
json
Respuesta a la consulta de estado
Consulta GET /api/v1/video/{taskId} para comprobar el estado:
json
Valores de estado
submitted: Tarea aceptada y en espera de procesamientoprocessing: Generación del vídeo en cursosucceed: Generación del vídeo completadafailed: Error en la generación del vídeo
Tiempo de procesamiento
El tiempo de procesamiento varía según la duración, la resolución y el estado de la cola.
Consulta el estado cada 5 a 10 segundos.
Prácticas recomendadas
- Parámetros obligatorios: incluye siempre
prompt,resolutionyduration. Para la generación a partir de texto y de referencias,aspect_ratioes opcional y su valor predeterminado es16:9 - Relación de aspecto al generar vídeo a partir de una imagen: no envíes
aspect_ratioen estas solicitudes - Vídeos de referencia: los vídeos son opcionales. Tanto la duración de cada vídeo como la duración total deben respetar los límites indicados
- Imágenes de referencia: las imágenes son opcionales con independencia de los vídeos y el audio. Puedes enviar hasta 10 URL de imágenes en formatos admitidos
- Audio de referencia: cada clip debe durar entre 2 y 30 segundos y ocupar como máximo 15 MB, con una duración total máxima de 30 segundos
- Orden de las referencias: coloca los elementos de
images,videosyaudiosen el orden deseado y respeta ese orden cuando los menciones en la instrucción - Sonido: omite
soundpara usar su valor predeterminadotrueo asígnalefalsepara desactivar la generación de sonido