> ## 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 Turbo Text-to-Video

Vidu Q3 Turbo Text-to-Video can generate high-quality videos with synchronized audio based on text descriptions, supporting up to 1080p resolution and durations from 1 to 16 seconds.

<Tip>
  This is an **asynchronous** API and only returns 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 results. If omitted or set to 0, a random number is used.

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

<ParamField body="audio" type="boolean" default={true}>
  Whether to use direct audio-video output capability (including dialogue and sound effects). false: output a silent video; true: output a video with sound. This parameter is supported only by Q3 series models.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Text description for video generation, up to 5000 characters.

  Length limit: 0 - 5000
</ParamField>

<ParamField body="wm_url" type="string">
  URL of the watermark image. If omitted, the default watermark is used (content generated by AI).
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Video duration (seconds), range 1-16, default 5 seconds.

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

<ParamField body="off_peak" type="boolean" default={false}>
  Off-peak mode. true: generate the video during off-peak periods, consuming fewer credits, with the task completed within 48 hours; false: generate the video immediately.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Whether to add a watermark. true: add a watermark; false: do not add a watermark. No watermark is added by default.
</ParamField>

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

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

<ParamField body="wm_position" type="integer" default={3}>
  Watermark position: 1=top-left, 2=top-right, 3=bottom-right, 4=bottom-left. Default is 3 (bottom-right).

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

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

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

## Response

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