进阶 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 天前 此页面对你有帮助吗?