进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读

第54章 Seedance 2.5 Flash 模型使用指南

Seedance 2.5 Flash 模型使用指南

本指南介绍如何通过 Leonardo.AI REST API 使用 Seedance 2.5 Flash 模型生成视频。

示例请求

```bash 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": "bytedance/seedance-2.5-flash", "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 " \ --header "content-type: application/json"

请求体参数

duration 类型:integer 可选。视频时长(秒)。取值为 4 至 30 的整数倍,默认为 8。

guidances 类型:object 可选。定义引导输入的对象(例如参考图像、音频、基础视频、起始/结束帧),影响生成结果。

guidances.audio_reference 类型:array 可选。用作生成参考的音频片段。最多 5 个条目,每个条目时长需在 2 至 30 秒之间。必须配合图像参考或视频参考使用,起始或结束帧不计入。每个条目包含 audio.id 和 audio.type(UPLOADED、GENERATED),可选 audio.duration。

guidances.end_frame 类型:array 可选。对参考图像的氛围或结构进行创造性再诠释。最多 1 个条目。每个条目包含 image.type(UPLOADED、GENERATED、VARIATION、URL、BASE64)和 image.id;若 type 为 URL 则需 image.url;若 type 为 BASE64 则需 image.data。可选 image.width、image.height。

guidances.image_reference 类型:array 可选。用于引导视频生成的参考图像。最多 10 个条目。每个条目包含 image.type(UPLOADED、GENERATED、VARIATION、URL、BASE64)和 image.id;若 type 为 URL 则需 image.url;若 type 为 BASE64 则需 image.data。可选 image.width、image.height 和 order。

guidances.start_frame 类型:array 可选。对参考图像的氛围或结构进行创造性再诠释。最多 1 个条目。每个条目包含 image.type(UPLOADED、GENERATED、VARIATION、URL、BASE64)和 image.id;若 type 为 URL 则需 image.url;若 type 为 BASE64 则需 image.data。可选 image.width、image.height。

guidances.video_reference_base 类型:array 可选。待编辑的基础视频。最多 5 个条目,每个条目时长需在 2 至 30 秒之间。每个条目包含 video.id 和 video.type(UPLOADED、GENERATED),可选 video.width、video.height、video.duration、video.motion_has_audio。

height 类型:integer 可选。输出像素高度。若指定 height,也需指定 width。两者需组成受支持的组合(参见“尺寸”),默认为 720。

model 类型:string 必填。指定生成使用的模型,设为 bytedance/seedance-2.5-flash。

motion_has_audio 类型:boolean 可选。视频生成是否包含音频,默认为 true。

omni_edit 类型:boolean 可选。控制如何处理 guidances.video_reference_base 中未指定 type 的条目。设为 true 时将视频视为待编辑的基础(edit-video);设为 false 或省略时,将其视为新视频的参考(reference-to-video)。

prompt 类型:string 必填。生成使用的提示词,最长 9999 字符。

public 类型:boolean 可选。控制生成内容是公开(true)还是私有(false)。

quantity 类型:integer 必填。生成输出的数量,必须为 1,默认为 1。

width 类型:integer 可选。输出像素宽度。若指定 width,也需指定 height。两者需组成受支持的组合(参见“尺寸”),默认为 1280。

尺寸

API 接受以下宽高比组合的 width 和 height 参数,默认为 1280 x 720。

480p 16:9(横屏) 854x480 4:3(横屏) 752x560 1:1(方形) 640x640 3:4(竖屏) 560x752 9:16(竖屏) 480x854 21:9(超宽屏) 992x432

720p 16:9(横屏) 1280x720 4:3(横屏) 1112x834 1:1(方形) 960x960 3:4(竖屏) 834x1112 9:16(竖屏) 720x1280 21:9(超宽屏) 1470x630

更新于 3 天前。本页是否对您有帮助?

评论 (0)