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-0-pro-fast - Versión rápida, generación veloz, adecuada para previsualizaciones e iteraciones
  • seedance-1-0-pro-quality - Versión de alta calidad, mayor tiempo de generación, mejor calidad
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)
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: 2 ~ 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:"1080p"
Resolución del videoOpciones:
  • 480p - Definición estándar
  • 720p - Alta definición
  • 1080p - Full HD
Predeterminado: 1080p
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

Combinaciones de resolución y proporción

array
Array de imágenes con roles para un control más precisoEjemplo:
  • Solo se admite una imagen por rol
  • last_frame solo es compatible con la versión seedance-1-0-pro-quality; la versión fast no admite primer y último fotograma juntos

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: Previsualización rápida en horizontal

Caso 2: Video corto vertical de alta calidad

Caso 3: Efecto de transición dinámica (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.