Seedance 图生视频参考图、音频与视频素材接入指南
Seedance 各型号的参考素材限制不同。本站 seedance-2.5-special2 支持最多 9 张参考图和 3 条参考音频,不支持参考视频;新接入可按统一 V1 文档使用 multipart 文件字段,不能把其他型号的素材额度套用过来。
先核对所选型号的素材能力
| 模型 ID | 参考图片 | 参考视频 | 参考音频 |
|---|---|---|---|
seedance-2.5-special2 | 最多 9 张 | 不支持 | 最多 3 条 |
seedance2.5-L | 最多 30 张 | 支持,遵守模型限制 | 支持,遵守模型限制 |
seedance2.5-buff | 最多 30 张 | 支持,遵守模型限制 | 支持,遵守模型限制 |
数量以外还需核对单文件大小、总大小、媒体时长和格式。当前特价2公开说明没有列出统一的文件大小上限,本页不把其他型号的上限当作它的参数。
特价2:上传一张参考图
下面示例会创建付费生成任务。密钥保存在自己的服务端环境变量中;reference.png 替换为有权使用的本地图片。
curl -X POST 'https://api.wxksai.com/v1/videos' \
-H "Authorization: Bearer $WXKS_API_KEY" \
-F 'model=seedance-2.5-special2' \
-F 'prompt=参考图中的商品置于窗边,镜头平稳推进,保持外观一致' \
-F 'seconds=10' \
-F 'resolution=1080p' \
-F 'aspect_ratio=16:9' \
-F 'images=@./reference.png'
多张图片重复 -F 'images=@./另一张图.png'。客户端会自动生成 multipart boundary,不要手动添加 Content-Type: application/json 或省略 boundary 的 multipart 请求头。保存返回的任务 ID,再按视频任务查询指南获取结果。
images、videos、audios 与 image 有何区别?
- 视频生成的参考图片字段为
images。 - 视频参考素材使用
videos,仅限支持参考视频的型号;特价2不支持。 - 参考音频使用
audios,数量遵守所选型号限制。 - 图片编辑接口
/v1/images/edits使用image,不要与视频参考图片字段混用。
公网 URL、Base64 和旧文件 ID 能直接复用吗?
不同型号的进阶素材格式不同,不存在所有型号通用的 JSON 素材字段。首次接入优先按当前文档上传本地文件;已有 URL、Base64 或 file_ ID 的客户端,应查看对应接口的兼容说明,避免跨型号混用。
上传失败先检查什么?
- 确认 model 是完整 ID,素材种类在该型号支持范围内。
- 检查文件是否真实存在、数量与大小是否超限;413 时优先检查上传大小限制。
- 特价2固定 1080P,比例支持 16:9、9:16、1:1、4:3、3:4、21:9;提示词不要与参数冲突。
- 提交超时先查原任务记录,不要通过重复上传和生成来判断第一次是否成功。
资料来源与核对范围
本文依据本站当前公开 API 文档、公开模型计费配置及模型广场整理,核对日期为 2026-11-02。示例说明接入方法;规格、价格、密钥权限和实时可用性以调用时配置及账户记录为准。