> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vidu Q3 Pro de imagen a vídeo

La herramienta de imagen a vídeo Vidu Q3 Pro puede convertir imágenes estáticas en vídeos dinámicos, generando movimiento natural y efectos de dinámica de escena más fluidos mientras mantiene la coherencia del sujeto.

<Tip>
  Esta es una API **asíncrona** que solo devolverá el task\_id de la tarea asíncrona. Debe usar ese task\_id para solicitar la [API de consulta de resultados de tarea](/es/docs/models/reference-get-async-task-result) y recuperar el resultado generado.
</Tip>

## Encabezados de solicitud

<ParamField header="Content-Type" type="string" required={true}>
  Valor de enumeración: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer: Bearer \{\{API Key}}.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="seed" type="integer">
  Semilla aleatoria, utilizada para generar resultados reproducibles; si es 0 o no se proporciona, se genera aleatoriamente

  Rango de valores: \[0, 2147483647]
</ParamField>

<ParamField body="audio" type="string">
  URL de audio personalizada para la música de fondo del vídeo; admite formatos mp3, wav, m4a y flac; máximo 20 MB
</ParamField>

<ParamField body="style" type="string" default="general">
  Estilo visual de salida; general es estilo realista, anime es estilo de animación

  Valores opcionales: `general`, `anime`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Array de URL de imágenes de referencia; admite `.jpg`, `.jpeg`, `.png`, `.webp`.
  Cada imagen no debe superar los 50 MB; la relación de aspecto debe estar entre 1:4 y 4:1.
  Actualmente solo se admite introducir 1 imagen
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Activa la sincronización entre audio e imagen; cuando se establece en true, el ritmo del audio se sincroniza con la dinámica del vídeo
</ParamField>

<ParamField body="prompt" type="string">
  Descripción del movimiento para la generación del vídeo; describe el movimiento de la escena, las acciones y los efectos dinámicos.

  Límite de longitud: 0 - 1500
</ParamField>

<ParamField body="wm_url" type="string">
  URL de imagen de marca de agua personalizada; admite formatos png, jpeg, jpg y webp; máximo 10 MB
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duración del vídeo (segundos)

  Rango de valores: \[1, 16]
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  Usa precios de horas valle; cuando se establece en true, la tarea espera en cola para procesarse durante horas valle y reducir costes
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Activa la marca de agua en el vídeo de salida
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Resolución del vídeo de salida

  Valores opcionales: `540p`, `720p`, `1080p`
</ParamField>

<ParamField body="wm_position" type="string">
  Posición de la marca de agua en el vídeo

  Valores opcionales: `top-left`, `top-right`, `bottom-left`, `bottom-right`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Relación de aspecto del vídeo de salida

  Valores opcionales: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`
</ParamField>

## Información de respuesta

<ResponseField name="task_id" type="string" required={true}>
  Use task\_id para solicitar la [API de consulta de resultados de tarea](/es/docs/models/reference-get-async-task-result) y recuperar la salida generada.
</ResponseField>