API Reference

Seedance 2.5 全能参考 API

Q: 如何调用？

提交生成参数与 Key，异步获取视频。

Q: 能否用于广告？

技术可接入；内容与版权合规需自行把关。

POST seedance-25-api ID 39

Seedance 2.5 全能参考视频生成接口，为更新一代参考控制能力，参数以文档为准。

POST https://apis.xiaobao.ink/api/video/seedancevtpf

获取 API Key 工作台 / 调试打开 Markdown

概述

2.5 参考能力
异步任务

适用场景

高可控视频生成
系列内容

调用约定

网关 · https://apis.xiaobao.ink
鉴权 · 请求携带 key（Query 或 JSON Body，以本接口为准）
回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200

鉴权

请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理创建密钥。

POST https://apis.xiaobao.ink/api/video/seedancevtpf
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

https://apis.xiaobao.ink/api/video/seedancevtpf?key=你的密钥

详细说明

请求HEADER：

名称	值
Content-Type	application/json

请求参数说明：

名称	必填	类型	示例值	说明
key	是	string	35kj5jnlj53453kl5j43nj5	接口密钥,在控制台->密钥管理查看
prompt	是	string	一个宁静的海滩在日落时分，海浪轻轻拍打着海岸，棕榈树随风摇曳，海鸥在橙色天空中飞翔。	用于生成视频的文本提示词。(最大长度:30000个字符)
callBackUrl	是	string	https://your-domain.com/api/callback	回调地址，接收生成任务完成更新的URL。但推荐用于生产环境使用。当生成完成后，系统将向此URL发送任务状态和结果的POST请求。
first_frame_url	否	string	http:://asset.cn/asset-20260404242101-76d.jpg	第一帧图像URL或资产路径，不能与reference_image_urls, reference_video_urls或reference_audio_urls同时使用。
last_frame_url	否	string	http:://asset.cn/asset-20260404242102-76d.jpg	结束帧图像URL或资产,最后帧URL不能单独传递;必须与第一个帧URL一起提供。
reference_image_urls	否	array[string<URL>]	["https://file.aiquickdraw.com/example1.png"]	参考图像URL列表, 支持 ≤30 张图片，最大 30M; 格式:jpeg、png、webp、bmp、tiff、gif。宽高比(宽度/高度):(0.4,2.5)宽度和高度(像素):(300,6000); 与首帧/末帧场景互斥。
reference_video_urls	否	array[string<URL>]	["https://file.aiquickdraw.com/example1.mp4"]	参考视频URL列表, 支持 ≤10 个视频，最长 30 秒;视频格式:mp4、mov,分辨率:480p，720p, 宽高比(宽度/高度):[0.4,2.5],宽高(像素):[300,6000],总像素:[640X640=409600，834X1112=9274083]，即宽度和高度的乘积必须满足范围要求[409600,927408]。大小:单个视频不超过200MB。帧率(FPS):[24,60]单个视频时长:[2,30]秒;与首帧/末帧场景互斥;参考视频总时长不得超过30秒。
reference_audio_urls	否	array[string<URL>]	["https://file.aiquickdraw.com/example1.wav"]	参考音频URL列表, 支持 ≤10 个音频，最长 30 秒;格式:wav、mp3;大小:单个音频文件大小不超过15MB;单个音频时长:[2,30]秒;与首帧/末帧场景互斥;参考音频的总时长不得超过30秒。
generate_audio	否	boolean	true	是否为视频生成音频。true:生成带音频, false:不生成音频, 注意:默认true。
resolution	否	string	720p	生成视频的分辨率，视频分辨率-480p用于更快生成，720p用于平衡。允许的值:480p、720p, 注意:默认720p。
aspect_ratio	否	string	16:9	生成视频的宽高比，视频宽高比配置。允许的值:1:1、4:3、3:4、16:9、9:16、adaptive(自适应)、21:9；默认值:16:9。
duration	否	int	10	生成视频的时长，视频时长在4到30秒之间；注意:默认15, 将参数设为-1以启用自动持续时间选择——模型会自行选择合适的持续时间（对于视频编辑任务，它会匹配输入视频的长度；对于其他任务类型，它会从有效范围内进行选择），而无需您指定确切的值。
web_search	否	boolean	false	是否启用在线搜索；注意:默认false。
nsfw_checker	否	boolean	true	是否启用NSFW检查器；注意:默认true。

返回参数说明：

名称	类型	说明
code	int	状态码
msg	string	状态信息
data	string	请求结果数据集
-- task_id	string	任务 ID 可以查询任务状态
debug	string/array	调试数据
exec_time	float	执行耗时
user_ip	string	客户端IP

常见问题

2.5 与 2.0 如何选择？

2.5 为更新版本，能力与计价可能不同，建议按文档与实测效果选择。

如何调用？

提交生成参数与 Key，异步获取视频。

支持哪些参考输入？

以该接口参数表为准。

能否用于广告？