> ## 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 Pro Fast 首尾帧

VIDU Q2 Pro Fast 快速模式收尾帧转视频 API，支持 720p、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="bgm" type="boolean" default={false}>
  是否为生成的视频添加背景音乐。true: 系统将从预设 BGM 库中自动挑选合适的音乐并添加；false: 不添加 BGM。BGM不限制时长，系统根据视频时长自动适配。
</ParamField>

<ParamField body="seed" type="integer">
  随机种子。当默认不传或者传0时，会使用随机数替代；手动设置则使用设置的种子。
</ParamField>

<ParamField body="images" type="array" required={true}>
  图像数组，第一张图片视作首帧图，第二张图片视作尾帧图，模型将以此参数中传入的图片来生成视频。支持输入两张图。注1: 首尾帧两张输入图的分辨率需相近，首帧图的分辨率/尾帧图的分辨率要在0.8～1.25之间；注2: 支持传入图片 Base64 编码或图片URL（确保可访问）；注3: 图片支持 png、jpeg、jpg、webp格式；注4: 图片大小不超过50M；注5: Base64编码必须包含适当的内容类型字符串，例如：data:image/png;base64,{base64_encode}

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

<ParamField body="is_rec" type="boolean" default={false}>
  是否使用推荐提示词。true：是，由系统自动推荐提示词，并使用提示词内容生成视频（每个任务多消耗10积分）；false：否，根据输入的prompt生成视频
</ParamField>

<ParamField body="prompt" type="string">
  文本提示词，生成视频的文本描述。注1：字符长度不能超过 2000 个字符；注2：若使用is\_rec推荐提示词参数，模型将不考虑此参数所输入的提示词

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

<ParamField body="wm_url" type="string">
  水印内容，此处为图片URL。不传时，使用默认水印：内容由AI生成
</ParamField>

<ParamField body="payload" type="string">
  透传参数，不做任何处理，仅数据传输。最多 1048576个字符。

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

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

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

<ParamField body="off_peak" type="boolean" default={false}>
  错峰模式。true：错峰生成视频（消耗积分更低，48小时内生成）；false：即时生成视频。注：错峰模式下提交的任务，未能完成的任务会被自动取消并返还积分；您也可以手动取消错峰任务。
</ParamField>

<ParamField body="meta_data" type="string">
  元数据标识，json格式字符串，透传字段，您可以自定义格式或使用示例格式。该参数为空时，默认使用vidu生成的元数据标识。
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  是否添加水印。默认不加水印。您可以通过watermarked\_url参数查询获取带水印的视频内容。
</ParamField>

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

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

<ParamField body="wm_position" type="integer" default={3}>
  水印位置，表示水印出现在图片的位置。1：左上角；2：右上角；3：右下角（默认）；4：左下角

  可选值：`1`, `2`, `3`, `4`
</ParamField>

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

  可选值：`auto`, `small`, `medium`, `large`
</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>