模型与参数
doubao-seedance-2-0-mini-260615默认首选,支持 480p / 720p。
doubao-seedance-2-0-fast-260128速度优先,支持 480p / 720p。
doubao-seedance-2-0-260128支持 480p / 720p / 1080p / 4K。
doubao-seedance-2-5-260628支持 480p / 720p / 1080p,最长 30 秒。
常用比例:16:9、9:16、1:1、4:3、3:4、21:9、adaptive。2.0 系列通常支持 4-15 秒,2.5 最长 30 秒。
提交任务
所有请求使用 ZPIKA API Key:Authorization: Bearer api-key。请先在 ZPIKA API 密钥页面创建密钥,并选择支持所用 Seedance 模型的对应分组;使用本站统一报价时通常选择 seedance 分组。
curl -X POST https://vip.zpika.com/v1/videos \
-H "Authorization: Bearer api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-0-mini-260615",
"prompt": "清晨湖面上的游轮缓慢前行,镜头稳定,无文字,无水印。",
"duration": 5,
"metadata": {
"resolution": "480p",
"ratio": "16:9",
"generate_audio": true
}
}'
提交成功会返回任务 id、status 和 progress。请保存任务 ID,不要在状态暂时未知时重复提交。已提交的 Seedance 任务也可在 ZPIKA 任务日志查看进度、制品并下载。
参考图片、视频和音频
参考素材放入 metadata.content,每项必须填写与素材用途匹配的 role;提示词中使用“图片1 / 视频1 / 音频1”说明用途。素材 URL 必须是服务端能直接读取的 HTTPS 文件地址,不能使用本地路径、blob: 地址或网盘分享页面。
{
"model": "doubao-seedance-2-0-mini-260615",
"prompt": "保持图片1的主体外观,延续视频1的镜头运动,参考音频1的节奏。",
"duration": 5,
"metadata": {
"resolution": "480p",
"ratio": "16:9",
"generate_audio": true,
"content": [
{ "type": "image_url", "image_url": { "url": "https://your-cdn.com/ref.jpg" }, "role": "reference_image" },
{ "type": "video_url", "video_url": { "url": "https://your-cdn.com/ref.mp4" }, "role": "reference_video" },
{ "type": "audio_url", "audio_url": { "url": "https://your-cdn.com/ref.mp3" }, "role": "reference_audio" }
]
}
}
content 中每项素材都必须指定正确的 role。画布与直接 API 的区别:ZPIKA 无限画布会按节点类型自动把普通图片、视频、音频转换为 reference_image、reference_video、reference_audio。当前使用 Seedance 2.5 时,在 @ 菜单选择图片后可继续选择“参考图 / 首帧 / 尾帧”,首尾帧会发送 first_frame / last_frame;素材编号仍按最终发送顺序生成。
首帧 / 首尾帧
本站当前链路仅开放已实测成功的 Seedance 2.5 首尾帧:可以只提供首帧;尾帧必须搭配首帧,ratio 填写 adaptive。同时提供首尾帧时,两张图片的像素尺寸必须完全一致。2.0 满血、Fast、Mini 的普通参考图仍可使用,但首帧/尾帧请求在当前链路实测返回 400,因此暂不开放;这不代表对模型原生能力作判断。
{
"model": "doubao-seedance-2-5-260628",
"prompt": "镜头从首帧平稳过渡到尾帧,保持主体一致。",
"duration": 5,
"metadata": {
"resolution": "720p",
"ratio": "adaptive",
"generate_audio": true,
"content": [
{ "type": "image_url", "image_url": { "url": "https://your-cdn.com/first.jpg" }, "role": "first_frame" },
{ "type": "image_url", "image_url": { "url": "https://your-cdn.com/last.jpg" }, "role": "last_frame" }
]
}
}
以上 2.5 示例要求两张图片像素尺寸完全一致;画布和直接 API 都使用 "ratio": "adaptive",不会把图片静默拉伸到固定画幅。只用首帧时删除 last_frame 项即可,不能只提交尾帧。
查询任务与下载
curl https://vip.zpika.com/v1/videos/task_id \
-H "Authorization: Bearer api-key"
| 状态 | 说明 | 处理方式 |
|---|---|---|
queued | 排队中 | 继续轮询 |
in_progress | 生成中 | 读取 progress |
completed | 已完成 | 优先读取顶层 video_url,兼容读取 content.video_url,或请求内容下载接口 |
failed | 生成失败 | 查看 error.message |
画布会在任务完成后先由服务器缓存视频,再下载到浏览器保存。返回的制品 URL 可能没有 .mp4 后缀,下载时以 HTTP Content-Type 为准,不要删除签名查询参数。任务尚未完成时显示“继续查询”;确认完成后,服务器缓存与浏览器下载累计等待超过 5 分钟会显示“重新下载”。两种操作都只恢复原任务,不会重新付费提交。
交给 AI 的接入文档
如果使用自己的画布、工作流或客户端,可以把下面这份标准 Markdown 文档直接发给大模型。它包含本站 Base URL、认证、模型名、请求结构、素材角色、轮询方式和禁止组合,不依赖 ZPIKA 无限画布。
打开 Seedance AI 接入规范(Markdown) →
给 AI 的建议指令:请阅读该文档,并严格按其中的本站接口格式实现 Seedance 创建、轮询和下载;不要改写字段名,不要把创建超时当成失败后立即重复提交。
在无限画布中使用 Seedance
- 先到 ZPIKA API 密钥页面创建密钥并选择对应分组;再登录画布,在“配置与用户偏好”中给视频分组填写该 Key,并确认已选择 Seedance 模型。
- 把图片、视频或音频拖入画布;从素材节点拉线,选择“视频生成”。
- 在生成输入框输入
@,选择已连接素材。普通素材会显示为@图片1、@视频1、@音频1;使用 2.5 时,选择图片后还可指定“参考图 / 首帧 / 尾帧”。 - 普通图片、视频、音频会分别转换为
reference_image、reference_video、reference_audio,首尾帧会转换为first_frame、last_frame。可以只选首帧;选择尾帧时必须先选首帧,且不能再混用普通参考素材。 - 首尾帧模式仅对当前链路实测成功的 2.5 开放,并锁定为自适应比例。同时提供首尾帧时两张图片必须像素尺寸一致,不一致时请先用图片节点的“裁剪”生成新图片。2.0 满血、Fast、Mini 请使用普通参考图。
- 提示词中出现任意
@标签时,只发送明确引用的素材;没有@时发送该任务全部已连接素材。 - 明确素材用途,例如“保持 @图片1 的产品外观,延续 @视频1 的镜头运动”。
- 选择模型和参数。默认是 Mini、480p、5 秒、16:9、生成声音,然后点击生成。
- 生成完成后等待“服务器下载 / 正在下载 / 正在保存视频”,视频会自动回填为画布节点;也可在 ZPIKA 任务日志查看进度、制品和下载入口。
客户价格参考
以下是客户实际支付人民币的近似价格,已按本站“支付 ¥36 充值 300 美元”换算。总体约为官方公开价格的 8.0-8.5 折,不同渠道和模型略有差异。
| 模型 | 分辨率 | 本站约付 |
|---|---|---|
| Seedance 2.0 Mini | 480p | 约 ¥0.10-0.20 / 秒 |
| Seedance 2.0 Mini | 720p | 约 ¥0.23-0.42 / 秒 |
| Seedance 2.0 Fast | 480p | 约 ¥0.20-0.30 / 秒 |
| Seedance 2.0 Fast | 720p | 约 ¥0.46-0.62 / 秒 |
| Seedance 2.0 满血 | 480p / 720p / 1080p / 4K | 约 ¥0.38-0.39 / ¥0.82-0.86 / ¥2.05-2.14 / ¥5.20-5.30 每秒 |
| Seedance 2.5 | 480p / 720p / 1080p | 约 ¥0.56-0.58 / ¥1.23-1.31 / ¥3.10-3.23 每秒 |
参考素材限制
- ZPIKA 无限画布按模型限制参考数量:Seedance 2.0 满血、Fast、Mini 最多 9 张图、3 个视频、3 个音频、合计 15 项;Seedance 2.5 最多 30 张图、10 个视频、10 个音频、合计 50 项。首尾帧计入图片数量,超过限制不会静默截断。
- 参考视频必须同时提供至少一张普通参考图片;画布中单个参考视频通常为 2-15 秒,全部参考视频总时长不超过 15 秒,单文件不超过 50MB。
- 画布中图片单文件不超过 30MiB,限制内保持原始格式、分辨率和画质上传;音频单文件不超过 15MB,且音频参考须同时提供图片或视频。
- 首帧、尾帧必须是图片,分别使用
first_frame、last_frame;可以只提供首帧,尾帧必须搭配首帧,首尾帧不可与普通参考图、参考视频、参考音频或视频编辑模式混用。 - 本站当前只对 Seedance 2.5 开放首尾帧,使用
adaptive;单独首帧允许非标准画幅,同时提供首尾帧时两张图片像素尺寸必须完全一致,不符合时应先裁剪,不要拉伸。 - 2.0 满血、Fast、Mini 当前仅开放普通参考图、参考视频等已验证模式,不开放首尾帧。普通参考素材和纯文生仍使用用户选择的固定比例。
content中普通图片、首尾帧、视频和音频必须指定对应role。- 视频建议使用 MP4 / MOV、H.264 / H.265、24-60 FPS。
- 包含未授权真人、隐私或受保护内容的素材可能被上游拒绝。