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

请求体参数

参数类型定义
durationinteger可选。视频时长(秒)。接受 4 到 30 的整数值,默认值为 8。
guidancesobject可选。定义引导输入(例如参考图像、音频、基础视频、起止帧)的对象,这些输入会影响生成结果。
guidances.audio_referencearray可选。指定用于引导的音频参考列表。最多 10 项。每项包含 audio.id 和 audio.type(UPLOADED、GENERATED),可选 audio.duration。
guidances.end_framearray可选。对参考图像风格或结构的创造性再诠释。最多 1 项。每项包含 image.id 和 image.type(INIT、GENERATION、UPLOADED、GENERATED、VARIATION)。
guidances.image_referencearray可选。用于引导视频生成的参考图像。最多 30 项。每项包含 image.id 和 image.type(INIT、GENERATION、UPLOADED、GENERATED、VARIATION),可选 order。
guidances.start_framearray可选。对参考图像风格或结构的创造性再诠释。最多 1 项。每项包含 image.id 和 image.type(INIT、GENERATION、UPLOADED、GENERATED、VARIATION)。
guidances.video_reference_basearray可选。待编辑的基础视频。最多 10 项。每项包含 video.id 和 video.type(UPLOADED、GENERATED),可选 video.width、video.height、video.duration、video.motion_has_audio。
heightinteger可选。输出高度(像素),默认值为 720。
modelstring必填。指定生成所用的模型,设置为 bytedance/seedance-2.5。
motion_has_audioboolean可选。视频生成是否包含音频,默认值为 True。
promptstring必填。生成所用的提示词,最大 9999 个字符。
publicboolean可选。控制生成结果是公开(true)还是私密(false)。
quantityinteger必填。生成输出的数量,默认值为 1,范围 1-1。
seednumber可选。生成用的随机种子值,默认值为 -1,范围 -1 到 4294967295。
widthinteger可选。输出宽度(像素),默认值为 1280。

尺寸规格

API 接受以像素为单位的整数宽度和高度值,默认为 1280 x 720。

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

评论 (0)