首尾帧生成视频

POST

/v1/videos

图生视频-首帧、图生视频-首尾帧、多模态参考生视频（包括参考图、视频、音频）为 3 种互斥场景，不可混用
多模态参考生视频可通过提示词指定参考图片作为首帧/尾帧，间接实现“首尾帧+多模态参考”效果。若需严格保障首尾帧和指定图片一致，优先使用图生视频-首尾帧（配置 role 为 first_frame/last_frame）
图生视频-首帧
字段role取值：需要传入1个 image_url 对象，字段 role 为 first_frame 或不填。
图生视频-首尾帧
字段role取值：需要传入2个image_url对象，且字段 role 必填。
首帧图片对应的字段 role 为：first_frame
尾帧图片对应的字段 role 为：last_frame
图生视频-参考图
字段role取值：必填，每张参考图对应的字段 role 均为：reference_image

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "镜头平稳推进，人物表情自然变化",
    "content": [
        {
            "type": "image_url",
            "role": "first_frame",
            "image_url": {
                "url": "https://example.com/start.png"
            }
        },
        {
            "type": "image_url",
            "role": "last_frame",
            "image_url": {
                "url": "https://example.com/end.png"
            }
        }
    ],
    "return_last_frame": true,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mliapi.com/v1/videos' \
--header 'Authorization: sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "镜头平稳推进，人物表情自然变化",
    "content": [
        {
            "type": "image_url",
            "role": "first_frame",
            "image_url": {
                "url": "https://example.com/start.png"
            }
        },
        {
            "type": "image_url",
            "role": "last_frame",
            "image_url": {
                "url": "https://example.com/end.png"
            }
        }
    ],
    "return_last_frame": true,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "task_qghsnDbtZo7FeliS4PAA1jGQsq1X1laH",
    "task_id": "task_qghsnDbtZo7FeliS4PAA1jGQsq1X1laH",
    "object": "video",
    "model": "doubao-seedance-2-0-fast-260128",
    "status": "queued",
    "progress": 0,
    "created_at": 1778479354
}

修改于 2026-05-14 08:09:11

文生视频

多图参考生成