进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第48章 Motion 2.0 视频生成指南
Motion 2.0
本指南介绍如何通过 Leonardo.AI REST API 使用 Motion 2.0 模型生成视频。
请求示例
curl --request POST \
--url https://cloud.leonardo.ai/api/rest/v2/generations \
--header 'accept: application/json' \
--header 'authorization: Bearer <YOUR_API_KEY>' \
--header 'content-type: application/json' \
--data '
{
"model": "motion_2.0",
"public": false,
"parameters": {
"prompt": "A koala and a cat playing together in a sunlit meadow",
"guidances": {
"start_frame": [
{
"image": {
"id": "<YOUR_START_IMAGE_ID>",
"type": "UPLOADED"
}
}
]
},
"quantity": 1,
"prompt_enhance": "OFF",
"frame_interpolation": true,
"width": 1280,
"height": 720
}
}
'
API 请求端点、请求头与参数
端点
https://cloud.leonardo.ai/api/rest/v2/generations
请求头
--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"
请求体参数
| 参数 | 类型 | 说明 |
|---|---|---|
| controls | array | Motion Control 项目数组(格式相同,但与 Motion Elements 分开定义)。最多 1 项。每项包含一个 kUUID(必填)和 weight(-2 到 2,默认为 1)。 |
| elements | array | Motion Elements 数组(格式相同,但与 Motion Control 分开定义)。每项包含一个 kUUID(必填)和 weight(-2 到 2,默认为 1)。默认为 []。 |
| frame_interpolation | boolean | 是否在视频生成中平滑融合帧。默认为 true。 |
| guidances.start_frame | array | 对参考图像的氛围或结构进行创意再演绎。最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)。 |
| height | number | 设置输出视频的高度(像素)。 |
| mode | string | 已弃用。width 和 height 是该模型的标准输入。为向后兼容保留,有效值为 RESOLUTION_480 和 RESOLUTION_720。默认为 RESOLUTION_480。 |
| model | string | 指定用于生成的模型,设为 motion_2.0。 |
| negative_prompt | string | 生成时使用的负面提示词,最多 1000 字符。 |
| prompt | string | 描述待生成视频内容的文本,最多 9999 字符。 |
| prompt_enhance | string | 启用或禁用提示词增强。有效值为 AUTO、ON 和 OFF。默认为 AUTO。 |
| public | boolean | 控制生成的视频是公开(true)还是私有(false)。 |
| quantity | number | 生成的输出数量。设为 1,默认为 1。 |
| seed | number | 视频生成的种子值,取值范围为 0 到 2147483637。 |
| style_ids | array | 视频模型的风格 UUID 数组(氛围、光照、色彩),可包含零个或多个。默认为 []。 |
| width | number | 设置输出视频的宽度(像素)。 |
尺寸
API 支持以下宽高比组合的 width 和 height 参数:
| 分辨率 | 宽高比 | 像素值(宽 x 高) |
|---|---|---|
| 480p | 16:9(横屏) | 832x480 |
| 4:5 | 576x720 | |
| 2:3 | 512x768 | |
| 9:16(竖屏) | 480x832 | |
| 720p | 16:9(横屏) | 1280x720 |
| 9:16(竖屏) | 720x1280 | |
| Auto | 由模型决定 | 0x0 |
width 和 height 必须成对提供,或成对省略。