进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读

第46章 Kling O3:通过 Leonardo.AI REST API 生成与编辑视频的指南

Kling O3
本指南介绍如何通过 Leonardo.AI REST API 使用 Kling O3 模型生成和编辑视频。

请求示例

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": "kling-video-o-3",
    "public": false,
    "parameters": {
      "prompt": "The woman plays with the cat",
      "duration": 3,
      "width": 1920,
      "height": 1080,
      "mode": "RESOLUTION_1080",
      "motion_has_audio": true,
      "guidances": {
        "start_frame": [
          {
            "image": {
              "id": "<YOUR_START_IMAGE_ID>",
              "type": "UPLOADED"
            }
          }
        ]
      }
    }
}
'

使用说明

API 请求的 Endpoint、Headers 与 Parameters

Endpoint

https://cloud.leonardo.ai/api/rest/v2/generations

Headers

--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"

Body Parameters

Parameter Type Definition
duration number 生成视频的时长,可设置为 3 到 15 秒。指定视频参考时最长为 10 秒。
guidances.end_frame array 最多 1 项。每项包含 image.id 和 image.type(GENERATED 或 UPLOADED)。仅在提供 start_frame 时可用;且不能同时提供 image_reference。
guidances.image_reference array 最多 7 张参考图片的数组,用于引导生成内容的视觉风格或元素;指定视频参考时最多 4 张。每项包含 image.id 和 image.type(GENERATED 或 UPLOADED)。不能同时提供 start_frame 或 end_frame。
guidances.start_frame array 最多 1 项。每项包含 image.id 和 image.type(GENERATED 或 UPLOADED)。不能同时提供 image_reference。
guidances.video_reference_base array 指定要编辑的视频。最多 1 项。每项包含 video.id 和 video.type(仅支持 GENERATED)。可与 image_reference 搭配使用。不能同时提供 start_frame 或 end_frame。
height number 设置视频高度(像素)。
mode string 画质模式。标准模式用 RESOLUTION_720,Pro 模式用 RESOLUTION_1080。默认为 RESOLUTION_1080。
model string 指定生成所用模型,设置为 kling-video-o-3。
motion_has_audio boolean 控制是否生成音频(true 为是,false 为否)。以视频参考方式编辑视频时不会保留音频。
prompt string 对要生成的视频内容的文字描述,最多 2500 个字符。
public boolean 控制生成的视频为公开(true)还是私有(false)。
width number 设置视频宽度(像素)。

尺寸

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

Resolution Aspect Ratio Pixel Values (Width x Height)
720p 16:9 1280x720
1:1 960x960
9:16 720x1280
1080p 16:9 1920x1080
1:1 1440x1440
9:16 1080x1920

注意:当未指定 width 和 height、但指定了 guidances.start_frame 时,生成结果的尺寸将以 guidances.start_frame 图片的尺寸为准。

更新于 19 天前 此页面对你有帮助吗?

评论 (0)