Skip to main content
POST

Autorizació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-1-5-pro - Versión 1.5 Pro, admite generación de audio y primer/último fotograma
string
requerido
Descripción del contenido del videoDescriba escenas, acciones y estilos en detalle para obtener mejores resultadosEjemplo: "Atardecer en la playa, luz dorada del sol sobre el mar, olas rompiendo suavemente en la arena"
integer
predeterminado:"5"
Duración del video (segundos)Rango admitido: 4 ~ 12 segundosPredeterminado: 5
string
predeterminado:"16:9"
Proporción del videoOpciones:
  • 16:9 - Horizontal
  • 9:16 - Vertical
  • 1:1 - Cuadrado
  • 4:3 - Proporción tradicional
  • 3:4 - Proporción tradicional vertical
  • 21:9 - Ultra ancha
Predeterminado: 16:9
string
predeterminado:"720p"
Resolución del videoOpciones:
  • 480p - Definición estándar
  • 720p - Alta definición
  • 1080p - Full HD
Predeterminado: 720p
integer
Semilla entera para controlar la aleatoriedad del contenido generadoRango de valores: número entero entre -1 y 2^32-1
  • Con la misma solicitud, si el modelo recibe valores de seed distintos (por ejemplo, no especificar seed o establecer seed en -1, lo que usará un número aleatorio), se generarán resultados diferentes
  • Con la misma solicitud, si el modelo recibe el mismo valor de seed, se generarán resultados similares, aunque no se garantiza que sean idénticos
boolean
predeterminado:"true"
Si se debe generar audioCuando se establece en true, el video incluirá audio de acompañamiento generado por IAPredeterminado: true
La generación de audio solo es compatible con la serie Seedance 2.0 y Seedance 1.5 Pro
boolean
predeterminado:"false"
Si se fija la cámaraCuando se establece en true, la posición de la cámara permanece fijaPredeterminado: false

Combinaciones de resolución y proporción

array<url>
Array de URLs de imagen para generación imagen-a-videoReglas de asignación automática de rol:
  • 1 imagen = primer fotograma
  • 2 imágenes = primer fotograma + último fotograma
Ejemplo: ["https://example.com/first.png", "https://example.com/last.png"]
  • image_urls e image_with_roles no se pueden usar al mismo tiempo
array
Array de imágenes con roles para un control más precisoEjemplo:
  • image_urls e image_with_roles no se pueden usar al mismo tiempo
  • El primer fotograma y el último fotograma solo admiten uno cada uno

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 con audio

Caso 2: Video corto vertical de alta calidad

Caso 3: Video dinámico a partir del primer fotograma

Caso 4: Efecto de transición con primer/último fotograma

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.0