图像生成视频使用指南

功能概览

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

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

在线调用：

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

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

前提条件

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

有效的拍我AI API Key；

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

购买的API积分或有效订阅

待处理图片格式为 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，需在效果管理中先行激活；部分模板不支持特定分辨率，详见效果管理页面说明
camera_movement	否	string	可以在文/图生视频添加运镜(支持v4,v4.5版本) 支持参数: "horizontal_left","horizontal_right","vertical_up","vertical_down", "zoom_in","zoom_out","crane_up", "quickly_zoom_in","quickly_zoom_out","smooth_zoom_in", "camera_rotation","robo_arm","super_dolly_out","whip_pan","hitchcock", "left_follow","right_follow","pan_left","pan_right","fix_bg"
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. 查询生成状态