API Reference

Seedance 2.5 reference API

Q: 如何调用？

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

Q: 能否用于广告？

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

POST seedance-25-api ID 39

Seedance 2.5 reference video generation. Parameters follow this page.

POST https://xiaoapis.com/api/video/seedancevtpf

Get an API key Console / try it Open Markdown

Overview

2.5 参考能力
异步任务

Use cases

高可控视频生成
系列内容

Conventions

Gateway · https://xiaoapis.com
Auth · send key (query or JSON body, as this API specifies)
Response · JSON. Check the business code and the HTTP status, not only HTTP 200

Authentication

Send the platform API key (query parameter key or JSON field key, as this page specifies). Create one in API key management.

POST https://xiaoapis.com/api/video/seedancevtpf
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

Request example

https://xiaoapis.com/api/video/seedancevtpf?key=你的密钥

Details

请求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

FAQ

2.5 与 2.0 如何选择？

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

如何调用？

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

支持哪些参考输入？

以该接口参数表为准。

能否用于广告？