首尾帧生成视频
POST
/openapi/v2/video/transition/generate
首尾帧生成视频
能力示例视频
接入流程
上传首帧图片 -> 上传尾帧图片 -> 发起首尾帧任务 -> 查询任务状态或等待 Webhook 回调接口地址
前置资源
| 资源 | 获取方式 |
|---|---|
first_frame_img | 调用「上传图片」接口获取首帧 img_id ，图片尺寸最大 10000 像素文件小于 20MB支持 PNG、WebP、JPEG、JPG，同时支持 MIME 类型 image/jpeg、image/jpg、image/png、image/webp |
last_frame_img | 调用「上传图片」接口获取尾帧 img_id ，图片尺寸最大 10000 像素文件小于 20MB支持 PNG、WebP、JPEG、JPG，同时支持 MIME 类型 image/jpeg、image/jpg、image/png、image/webp |
请求参数
| 参数 | 类 型 | 是否必填 | 说明 |
|---|---|---|---|
prompt | string | 是 | 过渡过程描述，最长 5000 characters |
model | string | 是 | 模型名称：c1、v6、v5.6、v5。新接入优先使用 c1 或 v6 |
duration | integer | 是 | 视频时长：c1 / v6 支持 1~15 秒；v5.6 支持 5 / 8 / 10 秒；v5 支持 5 / 8 秒。 |
quality | string | 是 | 360p、540p、720p、1080p |
first_frame_img | integer | 是 | 首帧图片 ID |
last_frame_img | integer | 是 | 尾帧图片 ID |
seed | integer | 否 | 随机种子，范围 0-2147483647 |
generate_audio_switch | boolean | 否 | 是否生成音效，默认开启 控制开关 Audio. true: Audio on, false: Audio off ，v5.5,v5.6,v6,c1 模型支持开关 |
最小请求示例
{
"prompt": "The character slowly transforms into a futuristic hero",
"model": "v6",
"duration": 5,
"quality": "720p",
"first_frame_img": 123456,
"last_frame_img": 123457,
"generate_audio_switch": false
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
Resp.video_id | integer | 视频任务 ID |
Resp.credits | integer | 本次任务消耗点数 |
响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"video_id": 123456,
"credits": 60
}
}注意事项
img_id。请求参数
Header 参数
Body 参数application/json必填
返回响应
请求示例请求示例
Shell
curl --location 'https://app-api.pixverseai.cn/openapi/v2/video/transition/generate' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
"model": "v6",
"prompt": "A cinematic scene with natural motion",
"duration": 5,
"quality": "720p",
"seed": 0,
"webhook_id": "your-webhook-id",
"first_frame_img": 123456789,
"last_frame_img": 123456790,
"generate_audio_switch": false
}'响应示例响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"video_id": 123456789
}
}修改于 2026-09-04 06:46:31