智能多帧 / 多帧过渡视频
POST
/openapi/v2/video/multi_transition/generate
多帧过渡视频 （Multi-transition）
能力示例视频
接入流程
上传多张关键帧图片 -> 设置每段 duration 和 prompt -> 发起多帧任务 -> 查询任务状态接口地址
核心参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
multi_transition | array | 是 | 包含 2–7 个关键帧。每项包含 img_id（当前账号下有效的已上传图片 ID）、duration 和 prompt，数组顺序就是画面过渡顺序 |
multi_transition[].img_id | integer | 是 | 上传图片后获得的图片 ID |
multi_transition[].duration | integer | 是 | 表示当前关键帧到下一关键帧的过渡时长；最后一项必须为 0 或省略。仅 2 帧时首段支持 1–8 秒；3–7 帧时每个非末尾段支持 1–5 秒，总时长为各段之和。 |
multi_transition[].prompt | string | 否 | 描述该段期望的运动或过渡效果；自动去除首尾空格，最长 2048 字符 |
model | string | 是 | 模型名称： v3.5 v4 v4.5 v5 |
quality | string | 是 | 分辨率 可选 360p 540p 720p 1080p |
motion_mode | string | 否 | normal 或 fast ；fast 1080p 单段不能超过 5 秒；v5 可支持本接口允许的 6–8 秒单段。 |
请求示例
{
"multi_transition": [
{
"img_id": 123451,
"duration": 3,
"prompt": "The character turns around"
},
{
"img_id": 123452,
"duration": 3,
"prompt": "The camera moves closer"
},
{
"img_id": 123453,
"duration": 0,
"prompt": ""
}
],
"model": "v5",
"quality": "360p",
"motion_mode": "normal"
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
ErrCode | integer | 错误码，0 表示成功 |
ErrMsg | string | 错误信息，成功时通常为 Success |
Resp.video_id | integer | 视频任务 ID，后续用于查询任务状态 |
Resp.credits | integer | 本次任务预估或实际消耗点数，具体以平台返回为准 |
响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"video_id": 123456,
"credits": 60
}
}下一步
video_id 获取生成进度和最终视频 URL。注意事项
请求参数
Header 参数
Body 参数application/json必填
返回响应
请求示例请求示例
Shell
curl --location 'https://app-api.pixverseai.cn/openapi/v2/video/multi_transition/generate' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
"model": "V5",
"quality": "720p",
"motion_mode": "normal",
"multi_transition": [
{
"img_id": 123456789,
"duration": 5,
"prompt": "Smooth cinematic transition"
},
{
"img_id": 123456789,
"duration": 5,
"prompt": "Smooth cinematic transition"
}
]
}'响应示例响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"video_id": 123456789
}
}修改于 2026-09-04 06:46:31