API Reference
Seedance 2.0 reference API
POST
seedance-ref-api
ID 18
Seedance 2.0 with richer reference controls when you need a consistent look.
POST
https://xiaoapis.com/api/video/seedancev
Overview
- 参考控制
- 异步生成
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/seedancev
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
Request example
https://xiaoapis.com/api/video/seedancev?key=你的密钥
Details
请求HEADER：
| 名称 | 值 |
|---|---|
| Content-Type | application/json |
请求参数说明：
| 名称 | 值 |
|---|---|
| Content-Type | application/json |
请求参数说明：
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| prompt | 是 | string | 一个宁静的海滩在日落时分，海浪轻轻拍打着海岸，棕榈树随风摇曳，海鸥在橙色天空中飞翔。 | 用于生成视频的文本提示词。(最大长度:20000个字符) |
| callBackUrl | 是 | string | https://your-domain.com/api/callback | 回调地址，接收生成任务完成更新的URL。但推荐用于生产环境使用。当生成完成后，系统将向此URL发送任务状态和结果的POST请求。 |
| first_frame_url | 否 | string | http:://asset.cn/asset-20260404242101-76d.jpg | 第一帧图像URL或资产路径。 |
| last_frame_url | 否 | string | http:://asset.cn/asset-20260404242102-76d.jpg | 结束帧图像URL或资产。 |
| reference_image_urls | 否 | array[string<URL>] | ["https://file.aiquickdraw.com/example1.png"] | 参考图像URL列表, 支持 ≤9 张图片，最大 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列表, 支持 ≤3 个视频，最长 15 秒;视频格式:mp4、mov,分辨率:480p，720p, 宽高比(宽度/高度):[0.4,2.5],宽高(像素):[300,6000],总像素:[640X640=409600，834X1112=9274083]，即宽度和高度的乘积必须满足范围要求[409600,927408]。大小:单个视频不超过50MB，时长[2,15]秒。帧率(FPS):[24,60]。 |
| reference_audio_urls | 否 | array[string<URL>] | ["https://file.aiquickdraw.com/example1.wav"] | 参考音频URL列表, 支持 ≤3 个音频，最长 15秒;格式:wav、mp3;大小:单个音频文件大小不超过15MB;单个音频时长:[2,15]秒;参考音频的总时长不得超过15秒。 |
| 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到15秒之间；注意:默认15。 |
| 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
全能参考是什么意思？
在生成时提供更多参考输入以提升可控性，具体字段见文档。
和 15fast 怎么选？
要速度选 15fast；要参考控制选全能参考或更新版本。
如何提交参考？
按文档的参考图/视频字段传公网 URL。
任务如何查询？
使用平台统一的异步查询方式（见该接口文档）。
输出分辨率？
以文档可选参数为准。
Related APIs
Full console doc (with the debugger):/doc/18