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

# VIDU Q2 参考生视频

VIDU Q2 参考图片转视频 API，支持多种分辨率选项。根据参考图片生成新的视频内容。

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 来检索视频生成结果。
</Tip>

## 请求头

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="bgm" type="boolean" default={false}>
  是否添加背景音乐
</ParamField>

<ParamField body="seed" type="integer">
  随机种子，用于控制生成结果的随机性。相同种子会产生相似的结果。
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  是否生成音频
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  文本提示词，可以使用 @1、@2 等占位符引用主体
</ParamField>

<ParamField body="duration" type="integer" required={true} default={5}>
  视频时长（秒），支持 1-10 秒

  可选值：`1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`
</ParamField>

<ParamField body="subjects" type="array" required={true}>
  主体列表，每个主体包含 id、images 和 voice\_id

  数组长度：1 - 无限制

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="id" type="string" required={true}>
      主体 ID，在 prompt 中使用 @id 引用
    </ParamField>

    <ParamField body="images" type="array" required={true}>
      主体图片 URL 列表

      数组长度：1 - 无限制
    </ParamField>

    <ParamField body="voice_id" type="string" default="">
      语音 ID，可选
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  是否添加水印
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  输出视频的分辨率。默认值为 720p。

  可选值：`540p`, `720p`, `1080p`
</ParamField>

<ParamField body="aspect_ratio" type="string">
  视频宽高比，例如 16:9、9:16、1:1 等
</ParamField>

<ParamField body="movement_amplitude" type="string">
  运动幅度，控制视频中物体的运动强度

  可选值：`auto`, `small`, `medium`, `high`
</ParamField>

## 响应

<ResponseField name="task_id" type="string" required={true}>
  异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 以获取生成结果
</ResponseField>

<ResponseField name="provider_request_id" type="string">
  Provider request ID (optional)
</ResponseField>