进阶 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"

请求体参数

参数类型说明
controlsarrayMotion Control 项目数组(格式相同,但与 Motion Elements 分开定义)。最多 1 项。每项包含一个 kUUID(必填)和 weight(-2 到 2,默认为 1)。
elementsarrayMotion Elements 数组(格式相同,但与 Motion Control 分开定义)。每项包含一个 kUUID(必填)和 weight(-2 到 2,默认为 1)。默认为 []。
frame_interpolationboolean是否在视频生成中平滑融合帧。默认为 true。
guidances.start_framearray对参考图像的氛围或结构进行创意再演绎。最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)。
heightnumber设置输出视频的高度(像素)。
modestring已弃用。width 和 height 是该模型的标准输入。为向后兼容保留,有效值为 RESOLUTION_480 和 RESOLUTION_720。默认为 RESOLUTION_480。
modelstring指定用于生成的模型,设为 motion_2.0。
negative_promptstring生成时使用的负面提示词,最多 1000 字符。
promptstring描述待生成视频内容的文本,最多 9999 字符。
prompt_enhancestring启用或禁用提示词增强。有效值为 AUTO、ON 和 OFF。默认为 AUTO。
publicboolean控制生成的视频是公开(true)还是私有(false)。
quantitynumber生成的输出数量。设为 1,默认为 1。
seednumber视频生成的种子值,取值范围为 0 到 2147483637。
style_idsarray视频模型的风格 UUID 数组(氛围、光照、色彩),可包含零个或多个。默认为 []。
widthnumber设置输出视频的宽度(像素)。

尺寸

API 支持以下宽高比组合的 width 和 height 参数:

分辨率宽高比像素值(宽 x 高)
480p16:9(横屏)832x480
4:5576x720
2:3512x768
9:16(竖屏)480x832
720p16:9(横屏)1280x720
9:16(竖屏)720x1280
Auto由模型决定0x0

width 和 height 必须成对提供,或成对省略。

评论 (0)