进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第57章 Wan 3.0视频生成API使用指南
Wan 3.0
本指南介绍如何通过 Leonardo.AI REST API 使用 Wan 3.0 模型生成视频。
请求示例
curl --request POST \
--url https://cloud.leonardo.ai/api/rest/v2/generations \
--header 'accept: application/json' \
--header 'authorization: Bearer ' \
--header 'content-type: application/json' \
--data '
{
"model": "alibaba/wan-3.0",
"public": false,
"parameters": {
"prompt": "The koala plays with the cat in a sunlit eucalyptus grove",
"guidances": {
"start_frame": [
{
"image": {
"id": "",
"type": "UPLOADED"
}
}
],
"end_frame": [
{
"image": {
"id": "",
"type": "UPLOADED"
}
}
]
},
"duration": 5,
"resolution": "1080p",
"motion_has_audio": true,
"width": 1920,
"height": 1080
}
}
'
API 请求端点、请求头与参数
端点
https://cloud.leonardo.ai/api/rest/v2/generations
请求头
--header "accept: application/json" \
--header "authorization: Bearer " \
--header "content-type: application/json"
请求体参数
| 参数 | 类型 | 说明 |
|---|---|---|
| duration | number | 生成视频的时长(秒),取 2 到 30 之间的整数,默认为 5。 |
| guidances.audio_reference | array | 用于引导生成的音频参考,最多 5 项。每项包含 audio.id 和 audio.type(GENERATED 或 UPLOADED),可选 audio.url 和 audio.duration。 |
| guidances.end_frame | array | 最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)。可对参考图片的氛围或结构进行创意再演绎。 |
| guidances.image_reference | array | 用于引导视频生成的参考图片,最多 10 项。每项包含 image.id 和 image.type,可通过可选的 order 控制其在 guidances 列表中的位置。 |
| guidances.start_frame | array | 最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)。可对参考图片的氛围或结构进行创意再演绎。 |
| guidances.video_reference_base | array | 待编辑的基础视频,最多 5 项。每项包含 video.id 和 video.type(GENERATED 或 UPLOADED)。 |
| guidances.webpage_reference | array | 以网页内容引导生成的公开网页 URL,最多 1 项。每项包含 webpage.url,该 URL 必须可公开访问。 |
| height | number | 输出视频的高度(像素)。设为 0 则由 resolution 自动推导。 |
| model | string | 指定生成所用的模型,必须设为 alibaba/wan-3.0。必填。 |
| motion_has_audio | boolean | 生成的视频是否包含音频,默认为 true。 |
| prompt | string | 视频内容的文字描述,最多 5000 字符。必填。 |
| public | boolean | 控制生成的视频是公开(true)还是私有(false)。 |
| quantity | number | 生成结果的数量,设为 1,默认为 1。 |
| resolution | string | 输出分辨率档位,在 width 和 height 为自动(0)时生效;显式指定的尺寸优先。有效值为 480p、720p 和 1080p,默认为 480p。 |
| seed | number | 生成的种子值,取值范围 0 到 2147483647。 |
| width | number | 输出视频的宽度(像素)。设为 0 则由 resolution 自动推导。 |
尺寸规格
API 支持以下宽高比组合的 width 和 height 参数:
| 分辨率 | 宽高比 | 像素值(宽 x 高) |
|---|---|---|
| 480p | 16:9(横屏) | 854x480 |
| 4:3 | 736x552 | |
| 1:1(正方形) | 640x640 | |
| 3:4 | 552x736 | |
| 9:16(竖屏) | 480x854 | |
| 720p | 16:9(横屏) | 1280x720 |
| 4:3 | 1104x828 | |
| 1:1(正方形) | 960x960 | |
| 3:4 | 828x1104 | |
| 9:16(竖屏) | 720x1280 | |
| 1080p | 16:9(横屏) | 1920x1080 |
| 4:3 | 1656x1242 | |
| 1:1(正方形) | 1440x1440 | |
| 3:4 | 1242x1656 | |
| 9:16(竖屏) | 1080x1920 | |
| 自动 | 由 resolution 决定 | 0x0 |
更新于 3 个月前 本页对你有帮助吗?