图像生成视频使用指南

概览

图生视频接口支持对静态图片应用运动效果、变换和可选风格迁移，生成动态短视频。您可以上传本地图片文件或通过上传接口获取的 img_id 来使用。

接口地址：
POST https://app-api.pixverseai.cn/openapi/v2/video/img/generate

API 参考文档：

图片上传接口：https://docs.platform.pai.video/300925712e0

生成任务接口：https://docs.platform.pai.video/300925768e0

前提条件

在使用本接口前，请确保您已具备：

有效的拍我AI API Key；

每次请求都携带唯一的 Ai-trace-id；

已开通并激活订阅计划，且账户中有足够可用额度；

待处理图片格式为 JPG/PNG/WebP，尺寸不超过 4000×4000 像素，文件大小 ≤ 20 MB。

使用步骤

1. 准备图片

为获得最佳效果，建议上传的图片：

分辨率较高（推荐 ≥ 1024×1024 像素）；

主题清晰，主体周围留有空白区域；

无过多文字水印；

光线充足，对比度良好。

2. 准备上传图片并获取 img_id

使用以下参数构建您的 API 请求：

重要提示：上传图片时，必须使用携带本地图片文件路径的 form-data 格式，目前不支持通过 URL 上传图片。

3. 构造 Image-to-Video 请求

使用获取到的 img_id 发起生成任务：

4. 参数说明

参数名	必选	类型	说明
model	是	string	模型版本，"v4.5"
prompt	是	string	视频文字描述，最长 2048 字符
negative_prompt	否	string	负面描述，最长 2048 字符，用于抑制不需要的内容
img_id	是	integer	图片上传接口返回的 img_id，用于生成任务
template_id	否	integer	效果模板 ID，需在效果管理中先行激活；部分模板不支持特定分辨率，详见效果管理页面说明
style	否	string	风格，可选："anime"、"3d_animation"、"day"、"cyberpunk"、"comic"，如非必要可不传
motion_mode	否	string	动作模式，默认 "normal"；可选 "fast"（仅支持 5 秒，1080p 不支持）
duration	是	integer	生成时长（秒），可选 5、8；1080p 模式仅支持 5
quality	是	string	分辨率质量，可选 "360p"(Turbo)、"540p"、"720p"、"1080p"
seed	否	integer	随机种子，32 位整数，范围 0–2147483647

5. 处理接口返回

提交生成任务后，会返回 video_id：

6. 查询生成状态

使用“获取视频生成状态”接口轮询 video_id，监控 status 字段；

当 status 从 5 变为 1 时，即可通过 url 下载视频。

下载生成视频

状态变更为 1 后，url 字段即为视频文件的下载链接，可直接访问或在程序中下载。

概览#

前提条件#

使用步骤#

1. 准备图片#

2. 准备上传图片并获取 img_id#

3. 构造 Image-to-Video 请求#

4. 参数说明#

5. 处理接口返回#

6. 查询生成状态#

概览

前提条件

使用步骤

1. 准备图片

2. 准备上传图片并获取 img_id

3. 构造 Image-to-Video 请求

4. 参数说明

5. 处理接口返回

6. 查询生成状态