> ## 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 Q3 Pro 图生视频

Vidu Q3 Pro 图像转视频工具可将静态图像转换为动态视频，在保持主体一致性的同时，生成自然运动与更流畅的场景动态效果。

<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="seed" type="integer">
  随机种子，用于可重复生成；0 或不传则随机生成

  取值范围：\[0, 2147483647]
</ParamField>

<ParamField body="audio" type="string">
  视频背景音乐的自定义音频URL；支持 mp3、wav、m4a、flac 格式；最大 20MB
</ParamField>

<ParamField body="style" type="string" default="general">
  输出视觉风格；general 为写实风格，anime 为动漫风格

  可选值：`general`, `anime`
</ParamField>

<ParamField body="images" type="array" required={true}>
  参考图片 URL 数组；支持 `.jpg`、`.jpeg`、`.png`、`.webp`。
  每张图片大小不超过 50MB；宽高比需在 1:4 与 4:1 之间。目前只支持输入 1 张图。
</ParamField>

<ParamField body="is_rec" type="boolean" default={false}>
  启用音画匹配；设为 true 时，音频节奏与视频动态同步
</ParamField>

<ParamField body="prompt" type="string">
  视频生成的运动描述；描述场景运动、动作和动态效果。

  长度限制：0 - 1500
</ParamField>

<ParamField body="wm_url" type="string">
  自定义水印图片URL；支持 png、jpeg、jpg、webp 格式；最大 10MB
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  视频时长（秒）

  取值范围：\[1, 16]
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  使用非高峰时段定价；设为 true 时，任务排队等待非高峰时段处理以降低成本
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  在输出视频上启用水印
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  输出视频分辨率

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

<ParamField body="wm_position" type="string">
  水印在视频上的位置

  可选值：`top-left`, `top-right`, `bottom-left`, `bottom-right`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  输出视频宽高比

  可选值：`16:9`, `9:16`, `4:3`, `3:4`, `1:1`
</ParamField>

## 响应

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