> ## 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 首尾帧生成视频可根据首帧和尾帧图片生成高质量视频,通过文本引导运动插值,支持最高 1080p 分辨率。

<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 表示随机。
</ParamField>

<ParamField body="audio" type="boolean" default={true}>
  是否在生成视频时同时生成音频。
</ParamField>

<ParamField body="images" type="array" required={true}>
  两张图片 URL 或 Base64 编码图片。第一张为首帧图,第二张为尾帧图。支持 png、jpeg、jpg、webp 格式,单张不超过 50MB,像素不小于 128x128,宽高比需小于 1:4 或大于 4:1。首尾帧两张图的分辨率需相近(首帧/尾帧比例在 0.8-1.25 之间)。

  数组长度：2 - 2
</ParamField>

<ParamField body="is_rec" type="boolean">
  是否启用推荐模式。
</ParamField>

<ParamField body="prompt" type="string">
  描述首尾帧之间期望的视频运动效果的文本。

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

<ParamField body="wm_url" type="string">
  自定义水印图片 URL。
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  生成视频的时长(秒),范围 1-16。

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

<ParamField body="off_peak" type="boolean" default={false}>
  是否使用错峰模式,费用更低。
</ParamField>

<ParamField body="watermark" type="boolean">
  是否添加水印。
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  生成视频的分辨率。

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

<ParamField body="wm_position" type="integer" default={3}>
  水印位置:1=左上角,2=右上角,3=右下角,4=左下角。

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

## 响应

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