> ## 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 Image-to-Video

The Vidu Q3 Pro image-to-video tool converts static images into dynamic videos, generating natural motion and smoother scene dynamics while maintaining subject consistency.

<Tip>
  This is an **asynchronous** API and will only return the asynchronous task's task\_id. You should use this task\_id to request the [Get Task Result API](/en/docs/models/reference-get-async-task-result) to retrieve the generated result.
</Tip>

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Enum value: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format: Bearer \{\{API Key}}.
</ParamField>

## Request Body

<ParamField body="seed" type="integer">
  Random seed for reproducible generation; 0 or omitted means random generation.

  Value range: \[0, 2147483647]
</ParamField>

<ParamField body="audio" type="string">
  Custom audio URL for the video's background music; supports mp3, wav, m4a, and flac formats; maximum 20MB.
</ParamField>

<ParamField body="style" type="string" default="general">
  Output visual style; general is a realistic style, and anime is an anime style.

  Optional values: `general`, `anime`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Array of reference image URLs; supports `.jpg`, `.jpeg`, `.png`, `.webp`.
  Each image must be no larger than 50MB; the aspect ratio must be between 1:4 and 4:1.
  Currently, only 1 input image is supported.
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  Enable audio-video matching; when set to true, the audio rhythm is synchronized with the video dynamics.
</ParamField>

<ParamField body="prompt" type="string">
  Motion description for video generation; describe scene motion, actions, and dynamic effects.

  Length limit: 0 - 1500
</ParamField>

<ParamField body="wm_url" type="string">
  Custom watermark image URL; supports png, jpeg, jpg, and webp formats; maximum 10MB.
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Video duration (seconds)

  Value range: \[1, 16]
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  Use off-peak pricing; when set to true, the task queues for off-peak processing to reduce costs.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Enable a watermark on the output video.
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Output video resolution

  Optional values: `540p`, `720p`, `1080p`
</ParamField>

<ParamField body="wm_position" type="string">
  Watermark position on the video

  Optional values: `top-left`, `top-right`, `bottom-left`, `bottom-right`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Output video aspect ratio

  Optional values: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`
</ParamField>

## Response

<ResponseField name="task_id" type="string" required={true}>
  Use the task\_id to request the [Get Task Result API](/en/docs/models/reference-get-async-task-result) to retrieve the generated output.
</ResponseField>