API Reference
Seedance 2.0 全能参考 API
POST
seedance-ref-api
ID 18
Seedance 2.0 全能参考视频生成，支持更丰富的参考控制，适合对一致性要求更高的成片。
POST
https://apis.xiaobao.ink/api/video/seedancev
概述
- 参考控制
- 异步生成
适用场景
- 角色/画面一致性
- 可控创意视频
调用约定
- 网关 ·
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/seedancev
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://apis.xiaobao.ink/api/video/seedancev?key=你的密钥
详细说明
请求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 |
常见问题
全能参考是什么意思？
在生成时提供更多参考输入以提升可控性，具体字段见文档。
和 15fast 怎么选？
要速度选 15fast；要参考控制选全能参考或更新版本。
如何提交参考？
按文档的参考图/视频字段传公网 URL。
任务如何查询？
使用平台统一的异步查询方式（见该接口文档）。
输出分辨率？
以文档可选参数为准。
相关接口
完整控制台文档（含调试台）：/doc/18