跳到主要内容

多帧生视频

更新时间：2026-03-09 11:32:15
根据多关键帧图片生成视频，必须是一个包含2-7个元素的数组。仅支持异步模式。调用该接口前，您需要先通过调用「上传文件」接口获取输入的原图路径；调用该接口后，您可通过调用「查询任务生成结果」接口获取视频的生成结果。
POST
https://cloud.baicaiinfer.com/v1/videos/generations
Authorizations
Authorizations：StringHeaderRequired

用户需使用已获取的API Key进行身份验证，以访问服务。

Body
application/json
selected_model：StringRequired

模型名称，取值：PixVerse-v5-MF2V。更多模型，可参考支持的模型和应用。

task_type：StringRequired

指定生成式模型需执行的任务类型，取值：multi_frame_img2video。更多任务类型，可参考支持的模型和应用。

input：ObjectRequired

输入参数集合。

input.resolution：StringRequired

分辨率（取值：360p、540p、720p、1080p）。

input.aspect_ratio：String

无需指定，以输入的首帧图的宽高比输出。

input.mutil_reference：Array<Object>Required

一个包含2-7个元素的数组。

input.mutil_reference.prompt：String

上一张图像继续延长的提示词，用来控制延长的视频内容。

input.mutil_reference.duration：IntRequired

每一帧继续延长的时长。多帧延长的总时长（即所有参考帧的累计时长）取值范围为 1~30 秒。每个参考帧的单独时长（duration）须遵循以下规则：每个参考帧的duration取值为 1~8 秒；当参考帧数量达到 3 个或以上时，每个duration取值为 1~5 秒。对于最后一帧的duration，必须设置为 0（表示序列在此结束）。

input.mutil_reference.urls：Array<String>Required

对应的关键帧图片url。

input.number_of_videos：Int

指定生成视频的数量，取值范围为1~4。默认值：1。

need_expand_prompt：Boolean

优化提示词（取值：true、false），默认值：false。

async：Boolean

采用异步方式处理请求，默认值：true。

Response
状态码：
200
application/json
code：IntRequired

表示请求处理状态的状态码。

0是成功标识，表示接口正常返回预期结果。
message：StringRequired

返回请求的处理结果，通常配合状态码使用，直观告知用户当前请求的具体情况。

data：objectRequired

任务的核心结果数据。

data.taskId：StringRequired

任务的唯一标识ID。

ts：StringRequired

响应的时间戳。

curl --location --request POST 'https://cloud.baicaiinfer.com/v1/videos/generations' \
--header 'Authorization: Bearer sk-ygktMgzqS9OnN3bmDbX*****' \
--header 'Content-Type: application/json' \
--data-raw '{
    "selected_model": "PixVerse-v5-MF2V",
    "task_type": "multi_frame_img2video",
    "input": {
        "resolution": "720p",
        "mutil_reference":[
           {
                "duration": 3,
                "urls" : ["https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/12.png"]
            },
            {
                "duration": 3,
                "urls" : ["https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/13.png"]
            },
            { 
                "duration": 0,
                "urls" : ["https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/11.png"]
            }
        ]
     }
}'
{
    "code": 0,
    "message": "任务提交成功",
    "data": {
        "taskId": "3524e0b3ba014b12ab1faf29f9f*****"
    },
    "ts": "2026-03-09T10:44:54.716004004+08:00[Asia/Shanghai]"
}