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

# VIDU Q2 Pro Fast Reference to Video

VIDU Q2 Pro Fast reference image/video to video API. Supports subject mode and non-subject mode with 720p and 1080p resolutions.

<Tip>
  This is an **asynchronous** API; only the **task\_id** will be returned. You should use the **task\_id** to request the [**Task Result API**](/api-reference/model-apis-task-result) to retrieve the video generation results.
</Tip>

## Request Headers

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

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

## Request Body

<ParamField body="bgm" type="boolean" default={false}>
  Whether to add background music.
</ParamField>

<ParamField body="seed" type="integer">
  Random seed for controlling generation randomness. Same seed produces similar results.
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  Whether to generate audio.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Text prompt. Use @1, @2 etc. to reference subjects.

  Length limit: 0 - 2000
</ParamField>

<ParamField body="duration" type="integer" required={true} default={5}>
  Video duration in seconds, 1-10.

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

<ParamField body="subjects" type="array" required={true}>
  Subject list, each containing name, images and voice\_id.

  Array length: 1 - unlimited
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Whether to add watermark.
</ParamField>

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

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

<ParamField body="aspect_ratio" type="string">
  Video aspect ratio, e.g. 16:9, 9:16, 1:1.
</ParamField>

<ParamField body="movement_amplitude" type="string">
  Movement amplitude, controls motion intensity in video.

  Optional values: `auto`, `small`, `medium`, `high`
</ParamField>

## Response

<ResponseField name="task_id" type="string" required={false}>
  Use the task\_id to request the [Task Result API](/api-reference/model-apis-task-result) to retrieve the generated outputs.
</ResponseField>