Seedance 2.0 API
Referencia completa de la API de los modelos de generación de vídeo Seedance 2.0 de ByteDance.
Variantes de modelos
Esta API admite seis variantes:
Comparación rápida
Relaciones de aspecto admitidas
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Opciones de resolución
Seedance 2.0 Texto a vídeo
Punto de conexión
POST /api/v1/video/task
Parámetros de solicitud
Obligatorios
Opcionales
Ejemplo de solicitud
javascript
Seedance 2.0 Imagen a vídeo
Parámetros de solicitud
Obligatorios
Opcionales
Ejemplo de solicitud
javascript
Seedance 2.0 Referencias a vídeo
Parámetros de solicitud
Obligatorios
Medios de referencia
Envía 1-9 imágenes. Solo pueden omitirse si se proporciona al menos un vídeo de referencia.
Marcadores de referencia @ (AT)
La función @ (AT) vincula los medios de referencia al prompt mediante marcadores numerados <<<...>>>. La numeración empieza en 1 de forma independiente para cada tipo de medio y sigue el orden de la matriz correspondiente:
Por ejemplo, si la primera imagen es una referencia de personaje y la segunda una de escena, utiliza <<<image_1>>> para el personaje y <<<image_2>>> para la escena en prompt. Cada marcador debe apuntar a un elemento existente en su matriz.
Opcionales
Ejemplo de solicitud
javascript
Ejemplo de solicitud Referencias a vídeo con @ (AT)
javascript
Variantes Fast
Las variantes Fast priorizan la velocidad de procesamiento. Todos los modelos Fast solo admiten salida en "480p" y "720p". Las demás estructuras de solicitud de Fast Texto a vídeo y Fast Imagen a vídeo coinciden con las de sus modelos estándar correspondientes, mientras que Fast Referencias a vídeo utiliza los mismos límites de medios de referencia que el modelo estándar.
Ejemplo de solicitud Fast
javascript
Ejemplo de solicitud Fast Referencias a vídeo con @ (AT)
javascript
Parámetros de Seedance 2.0 Fast Referencias a vídeo
Obligatorios
Medios de referencia
La misma convención de marcadores que empiezan en 1 también se aplica al modelo Fast Referencias a vídeo.
Opcionales
Límites de medios
Estos límites se aplican a las imágenes del primer y último fotograma y a los medios de referencia de los modelos de esta página.
El audio y el vídeo de referencia tienen cada uno un límite independiente de duración total de 15 segundos. Las cantidades son independientes: hasta 9 imágenes, 3 vídeos y 3 clips de audio. Añadir vídeos no reduce el número de imágenes permitido.
Todos los modelos usan 720p por defecto, pero se debe proporcionar resolution. El interruptor de sonido vale true por defecto; ni este ajuste ni el audio de referencia cambian el precio. Referencias a vídeo requiere al menos una imagen o un vídeo; no admite solicitudes solo con audio. Subir vídeos de referencia duplica el coste de generación, independientemente de su número o duración.
Formato de respuesta
Respuesta inicial
Todos los modelos devuelven un task_id para consultar el estado:
json
Respuesta de consulta
Consulta GET /api/v1/video/{taskId} para comprobar el estado:
json
Valores de estado
submitted: tarea aceptada y pendiente de procesamientoprocessing: generación de vídeo en cursosucceed: generación de vídeo completadafailed: error en la generación de vídeo
Tiempo de procesamiento
Modelos estándar: 3-8 minutos según la duración y la resolución.
Modelos Fast: 1-4 minutos para la mayoría de las configuraciones.
Consulta el estado cada 5-10 segundos.
Buenas prácticas
- Elegir la variante adecuada: usa modelos Fast para iterar y modelos estándar para el resultado final
- Describir claramente el movimiento: incluye descripciones concretas de movimiento en los prompts
- Elegir la resolución: todos los modelos estándar de Seedance 2.0 admiten
480p,720p,1080py4k; todos los Fast solo admiten480py720p - Ordenar las referencias: organiza
images,videosyaudiosdeliberadamente y referencia sus elementos de forma coherente en el prompt - Solicitudes solo con vídeo: utiliza una matriz
imagesvacía únicamente si proporcionas al menos un vídeo de referencia - Duración de medios: mantén cada audio y vídeo de referencia entre 2 y 15 segundos
- Uso del audio: omite
soundpara usar su valor predeterminadotrue, o establécelo enfalsepara desactivar el sonido generado