图像生成视频使用指南

功能概览

图生视频接口支持对静态图片应用运动效果、变换和可选风格迁移，生成动态短视频。您可以上传本地图片文件或通过上传接口获取的 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，尺寸不超过最长边 10000 像素，文件大小 ≤ 20 MB。

快速调用

1: 上传图片

2: 图生视频生成请求任务

3. 查询视频生成状态&下载视频

使用步骤

1. 准备图片

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

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

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

无过多文字水印；

光线充足，对比度良好。

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

使用以下参数构建您的 API 请求：
*img_id请使用uint64格式

3. 构造 Image-to-Video 请求

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

4. 参数说明

https://docs.platform.pai.video/300925768e0

5. 处理接口返回

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

6. 查询生成状态

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

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

下载生成视频

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

功能概览#

前提条件#

快速调用#

使用步骤#

1. 准备图片#

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

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

4. 参数说明#

5. 处理接口返回#

6. 查询生成状态#