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

请求体参数

参数类型说明
durationnumber生成视频的时长(秒),取 2 到 30 之间的整数,默认为 5。
guidances.audio_referencearray用于引导生成的音频参考,最多 5 项。每项包含 audio.id 和 audio.type(GENERATED 或 UPLOADED),可选 audio.url 和 audio.duration。
guidances.end_framearray最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)。可对参考图片的氛围或结构进行创意再演绎。
guidances.image_referencearray用于引导视频生成的参考图片,最多 10 项。每项包含 image.id 和 image.type,可通过可选的 order 控制其在 guidances 列表中的位置。
guidances.start_framearray最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)。可对参考图片的氛围或结构进行创意再演绎。
guidances.video_reference_basearray待编辑的基础视频,最多 5 项。每项包含 video.id 和 video.type(GENERATED 或 UPLOADED)。
guidances.webpage_referencearray以网页内容引导生成的公开网页 URL,最多 1 项。每项包含 webpage.url,该 URL 必须可公开访问。
heightnumber输出视频的高度(像素)。设为 0 则由 resolution 自动推导。
modelstring指定生成所用的模型,必须设为 alibaba/wan-3.0。必填。
motion_has_audioboolean生成的视频是否包含音频,默认为 true。
promptstring视频内容的文字描述,最多 5000 字符。必填。
publicboolean控制生成的视频是公开(true)还是私有(false)。
quantitynumber生成结果的数量,设为 1,默认为 1。
resolutionstring输出分辨率档位,在 width 和 height 为自动(0)时生效;显式指定的尺寸优先。有效值为 480p、720p 和 1080p,默认为 480p。
seednumber生成的种子值,取值范围 0 到 2147483647。
widthnumber输出视频的宽度(像素)。设为 0 则由 resolution 自动推导。

尺寸规格

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

分辨率宽高比像素值(宽 x 高)
480p16:9(横屏)854x480
4:3736x552
1:1(正方形)640x640
3:4552x736
9:16(竖屏)480x854
720p16:9(横屏)1280x720
4:31104x828
1:1(正方形)960x960
3:4828x1104
9:16(竖屏)720x1280
1080p16:9(横屏)1920x1080
4:31656x1242
1:1(正方形)1440x1440
3:41242x1656
9:16(竖屏)1080x1920
自动由 resolution 决定0x0

更新于 3 个月前 本页对你有帮助吗?

评论 (0)