> ## 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 Q2 Pro Fast: video desde referencia

API de conversión de imagen/vídeo de referencia a vídeo de VIDU Q2 Pro Fast. Admite modo con sujeto y modo sin sujeto, y admite las resoluciones 720p y 1080p.

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

## Encabezados de la solicitud

<ParamField header="Content-Type" type="string" required={true}>
  Valor enumerado: `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="bgm" type="boolean" default={false}>
  Si se debe añadir música de fondo
</ParamField>

<ParamField body="seed" type="integer">
  Semilla aleatoria, utilizada para controlar la aleatoriedad del resultado generado. La misma semilla producirá resultados similares.
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  Si se debe generar audio
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Prompt de texto; puede usar marcadores de posición como @1, @2, etc. para hacer referencia a los sujetos

  Valores opcionales: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="duration" type="integer" required={true} default={5}>
  Duración del vídeo (en segundos), admite de 1 a 10 segundos

  Valores opcionales: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="subjects" type="object[]" required={true}>
  Lista de sujetos; cada sujeto contiene name, images y voice\_id

  Longitud del array: 1 - sin límite

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="name" type="string" required={true}>
      Nombre del sujeto; se referencia en el prompt usando @{name}
    </ParamField>

    <ParamField body="images" type="string[]">
      Lista de URL de imágenes del sujeto, hasta 3 imágenes; cada una no debe superar los 20 MB

      Longitud del array: 0 - 3
    </ParamField>

    <ParamField body="voice_id" type="string">
      ID de voz, opcional
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Si se debe añadir una marca de agua
</ParamField>

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

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

<ParamField body="aspect_ratio" type="string">
  Relación de aspecto del vídeo, por ejemplo 16:9, 9:16, 1:1, etc.
</ParamField>

<ParamField body="movement_amplitude" type="string">
  Amplitud de movimiento, controla la intensidad del movimiento de los objetos en el vídeo

  Valores opcionales: `auto`, `small`, `medium`, `high`
</ParamField>

## Información de la respuesta

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