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 al encabezado de la solicitud:

Parámetros de la solicitud

string
requerido
Nombre del modelo de generación de videoModelos compatibles:
  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
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
Prompt de texto, máximo 2000 caracteresObligatorio para text-to-video. Opcional para los modos image-to-video y primer-último frame.Ejemplo: "A cat playing piano, camera slowly zooms in"
integer
predeterminado:"5"
Duración del video (segundos)Rango: 1 a 16Predeterminado: 5
string
predeterminado:"720p"
Resolución del videoOpciones:
  • 540p - Definición estándar
  • 720p - HD (predeterminado)
  • 1080p - Full HD
Predeterminado: 720p
string
Relación de aspecto del video (solo para el modo text-to-video)Opciones:
  • 16:9 - Horizontal
  • 9:16 - Vertical
  • 4:3 - Tradicional
  • 3:4 - Vertical tradicional
  • 1:1 - Cuadrado
Este parámetro solo está disponible en el modo text-to-video (cuando no se proporciona image_urls).
array<url>
Array de URLs de imágenes para la generación image-to-videoEl sistema determina automáticamente el modo de generación según el número de imágenes:
  • 0 imágenes (no proporcionadas): Modo text-to-video
  • 1 imagen: Modo image-to-video (la imagen se usa como frame inicial)
  • 2 imágenes: Modo primer-último frame (la primera imagen = primer frame, la segunda imagen = último frame)
Ejemplo: ["https://example.com/photo.jpg"]
  • Se admiten hasta 2 imágenes
  • Para el modo primer-último frame, deben proporcionarse exactamente 2 imágenes
  • Cuando se proporciona image_urls (ya sea 1 o 2 imágenes), el parámetro aspect_ratio no puede usarse — la relación de aspecto del video se determinará automáticamente según la imagen
boolean
predeterminado:"true"
Define si se genera audio (diálogo, efectos de sonido)Predeterminado: trueEstablezca el valor en false si necesita un video silencioso.
integer
Semilla entera para controlar la aleatoriedad del contenido generadoRango: entero entre -1 y 2^32-1
  • Con la misma solicitud, valores de semilla diferentes (incluyendo no especificada o -1, que usa un número aleatorio) producirán resultados diferentes
  • Con la misma solicitud, el mismo valor de semilla producirá resultados similares, pero no se garantiza una reproducibilidad exacta

Enrutamiento automático

El sistema determina automáticamente el modo de generación según el número de imágenes en image_urls:

Matriz de compatibilidad de parámetros

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 (Imagen única)

Caso 3: Video primer-último frame

Caso 4: Video silencioso (audio desactivado)

Consultar los resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarse. Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.