Skip to main content
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 audio
  • seedance-2.0-fast - Versión rápida, mismas funciones que la estándar con mayor velocidad de generación
  • seedance-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.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
Contenido revisado:
  • 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.
  • El contenido detectado devuelve HTTP 400 (nsfw_content_detected) de forma síncrona. No se crea ninguna tarea ni task_id, y no se descuenta cuota de generación de vídeo
  • Si la moderación no está disponible, agota el tiempo de espera o devuelve una respuesta no válida, se aplica fail-open y la generación continúa. Esta opción no es una garantía absoluta de seguridad del contenido
  • Las entradas que no puedan resolverse como una URL pública de imagen se omiten; los modelos no compatibles ignoran silenciosamente nsfw_check: true
Ejemplo:
Respuesta cuando se detecta contenido:
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 resultados
  • El prompt está limitado a 4000 caracteres, pero se recomiendan 500 caracteres.
  • El modelo seedance-2.0-mini no tiene límite de caracteres. Recomendación: los prompts en chino no deben superar los 500 caracteres y los prompts en inglés no deben superar las 1000 palabras. Un texto demasiado largo tiende a dispersar la información, y el modelo puede pasar por alto detalles y centrarse solo en los puntos clave, lo que provoca que falten algunos elementos en el vídeo.
Ejemplo: "A kitten yawning at the camera"
integer
predeterminado:"5"
Duración del video (segundos)Rango admitido: 4 a 15 segundosPredeterminado: 5
string
predeterminado:"16:9"
Proporción del videoLa proporción debe estar entre 0.5 y 2.5Opciones:
  • 16:9 - Horizontal
  • 9:16 - Vertical
  • 1:1 - Cuadrado
  • 4:3 - Proporción tradicional
  • 3:4 - Proporción tradicional vertical
  • 21:9 - Ultra ancha
  • adaptive - Adaptativa (coincide automáticamente con la imagen/video de entrada)
Predeterminado: 16:9
string
predeterminado:"720p"
Resolución del videoOpciones:
  • 480p - Definición estándar
  • 720p - Alta definición
  • 1080p - Full HD (solo admitida por seedance-2.0)
  • 4k - Ultra HD (solo admitida por seedance-2.0)
Predeterminado: 720p
integer
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: true
boolean
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: false
array<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
Ejemplo: ["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.
  • image_urls e image_with_roles no se pueden usar simultáneamente
  • Máximo de 9 imágenes de referencia
array
Array de imágenes con roles, admite especificar primer fotograma/último fotograma
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.
Ejemplo:
Formato Asset URL:
  • image_urls e image_with_roles no se pueden usar simultáneamente
  • Al usar imágenes de primer/último fotograma, video_urls y audio_urls no están disponibles
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
Ejemplo: ["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.
  • Al usar imágenes de primer/último fotograma (image_with_roles), los videos de referencia no están disponibles
  • Máximo de 3 videos de referencia, 1.8s < duración total < 15.2s
  • La resolución del video de referencia debe estar entre 480P y 720P
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
Ejemplo: ["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.
  • Al usar imágenes de primer/último fotograma (image_with_roles), el audio de referencia no está disponible
  • Máximo de 3 archivos de audio de referencia, duración total de 15s o menos
  • El audio de referencia debe usarse junto con imágenes de referencia o videos de referencia

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.

Diferencias con la versión 1.5 Pro