进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第53章 Leonardo.AI API 使用 Seedance 2.5 视频生成指南
Seedance 2.5
本指南介绍如何通过 Leonardo.AI REST API 使用 Seedance 2.5 模型生成视频。
示例请求
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": "bytedance/seedance-2.5",
"public": false,
"parameters": {
"prompt": "A koala and a cat playing together in a sunlit meadow",
"quantity": 1,
"width": 1280,
"height": 720,
"duration": 8,
"motion_has_audio": true
}
}
'API 请求端点、请求头和参数
端点
https://cloud.leonardo.ai/api/rest/v2/generations请求头
--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"请求体参数
| 参数 | 类型 | 定义 |
|---|---|---|
| duration | integer | 可选。视频时长(秒)。接受 4 到 30 的整数值,默认值为 8。 |
| guidances | object | 可选。定义引导输入(例如参考图像、音频、基础视频、起止帧)的对象,这些输入会影响生成结果。 |
| guidances.audio_reference | array | 可选。指定用于引导的音频参考列表。最多 10 项。每项包含 audio.id 和 audio.type(UPLOADED、GENERATED),可选 audio.duration。 |
| guidances.end_frame | array | 可选。对参考图像风格或结构的创造性再诠释。最多 1 项。每项包含 image.id 和 image.type(INIT、GENERATION、UPLOADED、GENERATED、VARIATION)。 |
| guidances.image_reference | array | 可选。用于引导视频生成的参考图像。最多 30 项。每项包含 image.id 和 image.type(INIT、GENERATION、UPLOADED、GENERATED、VARIATION),可选 order。 |
| guidances.start_frame | array | 可选。对参考图像风格或结构的创造性再诠释。最多 1 项。每项包含 image.id 和 image.type(INIT、GENERATION、UPLOADED、GENERATED、VARIATION)。 |
| guidances.video_reference_base | array | 可选。待编辑的基础视频。最多 10 项。每项包含 video.id 和 video.type(UPLOADED、GENERATED),可选 video.width、video.height、video.duration、video.motion_has_audio。 |
| height | integer | 可选。输出高度(像素),默认值为 720。 |
| model | string | 必填。指定生成所用的模型,设置为 bytedance/seedance-2.5。 |
| motion_has_audio | boolean | 可选。视频生成是否包含音频,默认值为 True。 |
| prompt | string | 必填。生成所用的提示词,最大 9999 个字符。 |
| public | boolean | 可选。控制生成结果是公开(true)还是私密(false)。 |
| quantity | integer | 必填。生成输出的数量,默认值为 1,范围 1-1。 |
| seed | number | 可选。生成用的随机种子值,默认值为 -1,范围 -1 到 4294967295。 |
| width | integer | 可选。输出宽度(像素),默认值为 1280。 |
尺寸规格
API 接受以像素为单位的整数宽度和高度值,默认为 1280 x 720。
更新于 19 天前 此页面对您有帮助吗?