seedance-2-0
Generación de video seedance-2.0
- Modo de procesamiento asíncrono, devuelve un ID de tarea para consultas posteriores
- Admite texto-a-video, imagen-a-video (primer fotograma/último fotograma)
- Admite video de referencia, audio de referencia y video con audio
- Admite proporciones horizontal, vertical, cuadrada, ultra ancha y adaptativa
POST
Autenticación
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala a la cabecera de la solicitud:
Parámetros de la solicitud
string
requerido
Nombre del modelo de generación de videoModelos admitidos:
seedance-2.0- Versión estándar, admite texto-a-video, imagen-a-video, video de primer/último fotograma, video de referencia, audio de referencia y video con audioseedance-2.0-fast- Versión rápida, mismas funciones que la estándar con mayor velocidad de generaciónseedance-2.0-mini- Versión mini, mismas funciones que la versión estándar
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.Respuesta cuando se detecta contenido:
true: revisar los prompts y las imágenes de entrada conomni-moderation-latestfalseu omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
- Texto:
prompt,negative_prompt - Imágenes:
image_urls,image_with_roles[].url,first_frame_image,last_frame_image - Recursos privados de imagen
asset://: resolver y revisar su URL pública original - Imágenes Base64: revisarlas después de convertirlas en una URL pública
video_urls, audio_urls y los recursos privados de vídeo/audio no se revisan, ya que el modelo de moderación no admite vídeo ni audio.ID de modelos compatibles: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (nombre antiguo) y seedance-2.5.La llamada de moderación no se factura al usuario que envía la solicitud de vídeo.Ejemplo:string
Descripción del contenido del videoRequerido para texto-a-video; opcional para imagen-a-video o video-de-referencia-a-videoSe recomienda especificar claramente el sujeto, la acción, el movimiento de cámara y el estilo para obtener mejores resultadosEjemplo:
"A kitten yawning at the camera"integer
predeterminado:"5"
Duración del video (segundos)Rango admitido:
4 a 15 segundosPredeterminado: 5string
predeterminado:"16:9"
Proporción del videoLa proporción debe estar entre 0.5 y 2.5Opciones:
16:9- Horizontal9:16- Vertical1:1- Cuadrado4:3- Proporción tradicional3:4- Proporción tradicional vertical21:9- Ultra anchaadaptive- Adaptativa (coincide automáticamente con la imagen/video de entrada)
16:9string
predeterminado:"720p"
Resolución del videoOpciones:
480p- Definición estándar720p- Alta definición1080p- Full HD (solo admitida porseedance-2.0)4k- Ultra HD (solo admitida porseedance-2.0)
720pinteger
Semilla aleatoria para controlar la aleatoriedad del contenido generado
- Con la misma solicitud, valores de seed distintos producirán resultados diferentes
- Con la misma solicitud, el mismo valor de seed producirá resultados similares, aunque no se garantiza una coincidencia exacta
boolean
predeterminado:"true"
Si se debe generar audio (video con audio)Cuando se establece en
true, el video incluirá audio de acompañamiento generado por IACuando se establece en false, el video no incluirá audio (video sin sonido)Predeterminado: trueboolean
predeterminado:"false"
Si se debe devolver la imagen del último fotogramaCuando se establece en
true, el resultado de la tarea devolverá adicionalmente la URL del último fotograma del video, que puede usarse para generación continua de videoPredeterminado: falsearray<object>
Lista de herramientas para capacidades mejoradas como búsqueda en la webEjemplo:
[{"type": "web_search"}]array<string>
Array de URLs de imagen para imagen-a-videoAdmite dos formatos:
- URL de imagen normal:
https://example.com/cat.jpg - Asset URL (asset aprobado):
asset://asset_a
["https://example.com/cat.jpg"] o ["asset://asset_a"]Las Asset URL son compatibles con todos los modelos Seedance 2.0:
seedance-2.0, seedance-2.0-fast y seedance-2.0-mini.array
Array de imágenes con roles, admite especificar primer fotograma/último fotogramaEjemplo:Formato Asset URL:
Cuando el campo
url usa una Asset URL, se admiten todos los modelos Seedance 2.0: seedance-2.0, seedance-2.0-fast y seedance-2.0-mini.array<string>
Array de URLs de video de referenciaAdmite dos formatos:
- URL de video normal:
https://example.com/reference.mp4 - Asset URL (asset aprobado):
asset://asset_a
["https://example.com/reference.mp4"] o ["asset://asset_a"]Las Asset URL son compatibles con todos los modelos Seedance 2.0:
seedance-2.0, seedance-2.0-fast y seedance-2.0-mini.array<string>
Array de URLs de audio de referenciaAdmite dos formatos:
- URL de audio normal:
https://example.com/speech.wav - Asset URL (asset aprobado):
asset://asset_a
["https://example.com/speech.wav"] o ["asset://asset_a"]Las Asset URL son compatibles con todos los modelos Seedance 2.0:
seedance-2.0, seedance-2.0-fast y seedance-2.0-mini.Respuesta
integer
Código de estado de la respuesta, 200 en caso de éxito
array
Array de datos de la respuesta
Casos de uso
Caso 1: Texto-a-video
Caso 2: Imagen-a-video (primer fotograma)
Caso 3: Video con primer/último fotograma
Caso 4: Video-de-referencia-a-video
Caso 5: Video de referencia + audio de referencia
Caso 6: Video con audio
Caso 7: Generación continua de video (devolver último fotograma)
Caso 8: Generación con versión rápida
Caso 9: Imágenes de referencia + video de referencia + audio de referencia (video multimodal)
Combine imágenes de referencia, video de referencia y audio de referencia para generar un video publicitario inmersivo en primera persona. Ideal para promociones de productos, anuncios de marca y otros escenarios que requieran la fusión de material de múltiples fuentes.Caso 10: Imagen-a-video con Asset URL
Los assets de avatar virtual aprobados pueden pasarse directamente como imágenes de referencia sin volver a subirlos ni someterlos a revisión nuevamente.Caso 11: Especificar retrato de referencia con Asset URL (image_with_roles)
Caso 12: Versión rápida + imagen-a-video con Asset URL
Caso 13: Imagen con Asset URL + video de referencia (transferencia de movimiento)
Combine un asset de retrato aprobado con un video de referencia para que el personaje realice los movimientos especificados.Consultar los resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un
task_id al enviarla. Use el endpoint Obtener estado de tarea para consultar el progreso y los resultados de la generación.