Seedance
字节 Seedance 官方型号:2.5 / 2.0 / 2.0 Fast / 2.0 Mini,参考图、参考视频、参考音频、首尾帧都收;按 token 计费,与字节官方(火山方舟)刊例同价
POST /v1/videos,model 为 doubao-seedance-2-5-260628 / doubao-seedance-2-0-260128 /
doubao-seedance-2-0-fast-260128 / doubao-seedance-2-0-mini-260615(就是字节官方的模型 ID)。
按 token 计费,时长和分辨率直接决定价格,见计费。本页结论来自对本网关的真实调用,最后验证:2026-09-21。
旧的一口价型号已下线
seedance-2.5 / seedance-2.5-plus / seedance-2.5-pro / seedance-2.0 四个一口价模型名的上游已停供,
提交会返回 model_not_found。改用本页的官方模型 ID:请求字段完全一样,多传一个 resolution,
计费从一口价变成按时长 × 分辨率算。
基本调用
# 1. 提交
curl https://www.vibeapi.cn/v1/videos \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-5-260628",
"prompt": "中国水墨动画。鲲化为鹏,自暴风怒海中腾空而起,双翼横贯画面,翼尖化入云雾。大量留白,湿笔在宣纸上缓缓洇开,单色水墨仅带一点淡赭",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# 2. 轮询(每 10~15 秒一次)
curl "https://www.vibeapi.cn/v1/videos/$TASK_ID" -H "Authorization: Bearer $API_KEY"
# 3. 取片
curl -L "https://www.vibeapi.cn/v1/videos/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" -o output.mp4import time, requests
BASE = "https://www.vibeapi.cn/v1"
H = {"Authorization": "Bearer YOUR_API_KEY"}
task = requests.post(f"{BASE}/videos", headers=H, json={
"model": "doubao-seedance-2-5-260628",
"prompt": "中国水墨动画。鲲化为鹏,自暴风怒海中腾空而起,双翼横贯画面,翼尖化入云雾。大量留白,湿笔在宣纸上缓缓洇开,单色水墨仅带一点淡赭",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9",
}).json()
while True:
s = requests.get(f"{BASE}/videos/{task['id']}", headers=H).json()
if s["status"] in ("completed", "failed"):
break
time.sleep(12)
if s["status"] == "completed":
url = s.get("metadata", {}).get("url") or f"{BASE}/videos/{task['id']}/content"
open("output.mp4", "wb").write(requests.get(url, headers=H).content)import fs from "fs";
const BASE = "https://www.vibeapi.cn/v1";
const H = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
const task = await (await fetch(`${BASE}/videos`, {
method: "POST",
headers: H,
body: JSON.stringify({
model: "doubao-seedance-2-5-260628",
prompt: "中国水墨动画。鲲化为鹏,自暴风怒海中腾空而起,双翼横贯画面,翼尖化入云雾。大量留白,湿笔在宣纸上缓缓洇开,单色水墨仅带一点淡赭",
duration: 10,
resolution: "720p",
aspect_ratio: "16:9",
}),
})).json();
let s;
while (true) {
s = await (await fetch(`${BASE}/videos/${task.id}`, { headers: H })).json();
if (s.status === "completed" || s.status === "failed") break;
await sleep(12_000);
}
if (s.status === "completed") {
const url = s.metadata?.url ?? `${BASE}/videos/${task.id}/content`;
fs.writeFileSync("output.mp4", Buffer.from(await (await fetch(url, { headers: H })).arrayBuffer()));
}四个型号
四个都是字节官方型号,能力和上限就是官方文档写的那套。差别在时长上限、分辨率档位、参考素材数量和价格:
doubao-seedance-2-5-260628 | doubao-seedance-2-0-260128 | doubao-seedance-2-0-fast-260128 | doubao-seedance-2-0-mini-260615 | |
|---|---|---|---|---|
| 时长 | 4–30 秒 | 4–15 秒 | 4–15 秒 | 4–15 秒 |
| 分辨率 | 720p · 1080p | 720p · 1080p | 720p | 720p |
| 参考图 | 最多 30 张 | 最多 9 张 | 最多 9 张 | 最多 9 张 |
| 参考视频 | 最多 10 条,总时长 ≤ 30 秒 | 最多 3 条,总时长 ≤ 15 秒 | 同 2.0 | 同 2.0 |
| 参考音频 | 最多 10 段,总时长 ≤ 30 秒;可只传音频 | 最多 3 段,总时长 ≤ 15 秒;不能只传音频 | 同 2.0 | 同 2.0 |
| 首尾帧 | 支持 | 支持 | 支持 | 支持 |
| 有声视频 | 总带音轨 | 总带音轨 | 总带音轨 | 总带音轨 |
| 720p 每秒参考价 | 约 ¥1.5 | 约 ¥1.0 | 约 ¥0.8 | 约 ¥0.5 |
怎么选:要 30 秒连贯长片、要 1080p、素材多,用 2.5;产品展示、短镜头、成本敏感用 2.0 Mini(最便宜,出片也最快);
2.0 Fast 是 Mini 和 2.0 之间的档;2.0 标准版比 2.5 便宜三成、支持 1080p,但最长 15 秒。
素材审核:公众人物、政治人物等敏感内容的参考图会被拒(错误 InputImageSensitiveContentDetected,自动全额退款);普通真人肖像 2026-09-21 实测可以通过,但官方仍标注不保证,接入时预留一次重试。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 四个官方模型 ID 之一 |
prompt | string | 描述画面与运镜;引用参考素材用 @Image1 / @Video1 / @Audio1 这样的编号 |
duration | number | 秒。2.5 为 4–30,2.0 系列为 4–15;不传按 5 秒。每一秒都计费,别再习惯性用满 |
resolution | string | 720p(默认)或 1080p;1080p 只有 2.5 和 2.0 标准版有。480p / 4k 不开放,传了 400 |
aspect_ratio | string | 16:9 4:3 1:1 3:4 9:16 21:9,或 adaptive(跟随首帧 / 参考视频);不传时上游按素材自适应,纯文生视频默认 16:9 |
image_urls | string[] | 参考图直链数组,上限见上表;等价写法 images |
video_urls | string[] | 参考视频直链数组,mp4 / mov,单条 2–30 秒(2.0 系列 2–15 秒),≤ 200 MB |
audio_urls | string[] | 参考音频直链数组,wav / mp3,单段 2–30 秒(2.0 系列 2–15 秒),≤ 15 MB |
reference_images | object[] | [{url, role}],role 取 reference_image / first_frame / last_frame;首尾帧只能走这个字段 |
input_reference | string | 单张图作首帧,等价于 reference_images: [{url, role: "first_frame"}] |
generate_audio | boolean | 是否生成同步音轨,默认 true。当前传 false 不生效,成片总带音轨(2026-09-21 实测),要无声自己去掉音轨 |
watermark | boolean | 是否加水印,默认 false |
seed | number | 随机种子,同种子同提示词结果接近 |
omni_reference_task_type | string | 仅 2.5:reference(参考生视频,默认由模型判定);edit / extend 两类子任务本接口暂不开放 |
size 传 1280x720 / 1920x1080 也会被归到对应档位;resolution 与 size 同时给时以 resolution 为准。
首尾帧 vs 参考图
首尾帧(first_frame / last_frame)和参考图(reference_image)是两种互斥的任务,不能同时出现,
首帧尾帧各只能一张。要"首帧锁构图 + 多张参考",把首帧那张放进 image_urls[0],在提示词里写明 @Image1 作为开场画面。
{
"model": "doubao-seedance-2-0-260128",
"prompt": "从首帧的日出海面缓慢推进到尾帧的黄昏渔港,光线连续变化",
"duration": 8,
"resolution": "1080p",
"reference_images": [
{ "url": "https://example.com/sunrise.png", "role": "first_frame" },
{ "url": "https://example.com/dusk.png", "role": "last_frame" }
]
}传多张参考素材,以及在提示词里点名
三个数组都是顺序即编号:image_urls[0] 就是 @Image1,image_urls[1] 是 @Image2,
视频与音频同理是 @Video1、@Audio1。提示词里不点名时模型会自行参考全部素材,
点名之后它才知道"主体用哪张、场景用哪张、节奏跟哪段音频"。
curl https://www.vibeapi.cn/v1/videos \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-5-260628",
"prompt": "@Image1 里的机器人走进 @Image2 的老街,步态参考 @Video1,动作节奏跟随 @Audio1 的鼓点,黄昏光线保持不变,镜头跟随背影缓缓推进",
"duration": 12,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_urls": ["https://example.com/robot.png", "https://example.com/old-street.png"],
"video_urls": ["https://example.com/walk-cycle.mp4"],
"audio_urls": ["https://example.com/drums.mp3"]
}'几条实测经验:
- 主体放第一张。素材没点名时模型偏向把
@Image1当主角,其余当场景 / 风格。 - 素材链接必须是公网可直接下载的 HTTPS 直链,签名 URL 要保证任务期间不过期。图片 jpeg / png / webp,边长 300–6000 px,≤ 30 MB。
- 比例、时长只用参数控制,不要写进提示词("竖屏" "8 秒" 会和参数冲突)。
- 带参考视频的任务单价更低(见下),但参考视频的秒数会计入 token,总价未必更便宜。
- 2.0 系列不能只传音频,至少配一张图或一条视频;2.5 可以只传音频。
- 素材数量、时长、分辨率超出型号上限时,提交阶段直接 HTTP 400,不扣费。
- 参考图含公众人物会在异步阶段被审核拒掉;普通人像可以过(实测 1 例),仍按可能重试来设计。
计费
按 token 计,与字节官方(火山方舟)刊例同价,单价按「输出分辨率」和「输入是否含参考视频」分档; 分辨率越高、时长越长,token 越多:
token ≈ (参考视频总秒数 + 输出秒数) × 输出宽 × 输出高 × 24 / 1024准确数以任务完成后上游返回的 usage.total_tokens 为准;提交时按预估预扣,完成后按实际 token 多退少补,失败全额退回。
单价见 https://www.vibeapi.cn/pricing ;下面是官方给的每条参考价(16:9,5 秒,不含参考视频),方便估算:
| 分辨率 | 2.5 | 2.0 | 2.0 Fast | 2.0 Mini |
|---|---|---|---|---|
| 720p | ¥7.56(¥1.51/秒) | ¥4.97(¥0.99/秒) | ¥4.00(¥0.80/秒) | ¥2.48(¥0.50/秒) |
| 1080p | ¥18.71(¥3.74/秒) | ¥12.39(¥2.48/秒) | — | — |
时长线性外推:2.5 720p 30 秒约 ¥45,1080p 30 秒约 ¥112。 带参考视频时 token 单价降到六成左右,但参考视频时长计入 token。
已知限制(2026-09-21 实测)
| 限制 | 说明 | 怎么办 |
|---|---|---|
| 成片总带音轨 | generate_audio: false 当前不生效,成片音轨与默认一样大 | 要无声在自己那边去掉音轨;修好会在本页更新 |
| 1080p 按更高单价计 | 720p 与 1080p 是两档单价,1080p 每百万 token 约贵 10%,token 数还是 720p 的 2.25 倍 | 预览用 720p,定稿再出 1080p |
| 取片速度不稳 | 同样几 MB 的成片,/content 有时 4–8 秒,有时一分钟 | 下载超时按 3 分钟设,失败重试同一个地址即可,不要重新提交任务 |
| 只有 720p / 1080p | 不接受 480p 与 4k,传了直接 400 | — |
| 不支持视频编辑 / 延长 | 2.5 的 edit / extend 子任务需要 duration: -1,本接口只接受 4–30 的整数秒 | 只做参考生视频;要编辑先把原片当 video_urls 参考重新生成 |
| 敏感内容素材会被拒 | 公众人物 / 政治人物肖像提交约 2 分钟后 failed(InputImageSensitiveContentDetected),全额退款;普通真人肖像实测可过 | 换素材;人物类需求预留一次重试 |
实测样本(2026-09-21)
| 请求 | 成片 | 用时 | 实扣 |
|---|---|---|---|
| Mini · 720p · 6 秒 · 9:16 · 1 图 + 1 条 10 秒参考视频 + 1 段音频 | 720×1280,6.05 秒,有音轨 | 6.3 分钟 | ¥4.85(参考视频 10 秒计入 token,按含视频单价) |
| 2.0 · 1080p · 5 秒 · 首尾帧 | 1920×1080,5.04 秒 | 7.2 分钟 | ¥12.50(官方参考价 ¥12.39) |
2.5 · 720p · 5 秒 · input_reference 竖版首帧 | 720×1280(跟随首帧自适应),5.06 秒 | 9.0 分钟 | ¥7.29(官方参考价 ¥7.56) |
| Mini · 720p · 5 秒 · 纯文生 | 1280×720,5.06 秒 | 5.7 分钟 | ¥2.50(官方参考价 ¥2.48) |
轮询超时按 20 分钟设;一次生成 5–9 分钟,2.5 与 1080p 偏慢。
响应
提交返回 {"id": "task_…", "status": "queued"};GET /v1/videos/{id} 轮询到 completed 后,
metadata.url 指向 /v1/videos/{id}/content,带 Authorization 取片。完整流程与错误码见视频生成。
逐型号示例
doubao-seedance-2-5-260628 · 30 秒长片 · 1080p
{
"model": "doubao-seedance-2-5-260628",
"prompt": "@Image1 的水墨群山,云海缓缓流动,一叶扁舟自左向右穿过江面,镜头极缓慢推进,大量留白",
"duration": 30,
"resolution": "1080p",
"aspect_ratio": "16:9",
"image_urls": ["https://example.com/ink-mountains.png"]
}doubao-seedance-2-0-260128 · 多图 + 参考视频 + 参考音频
{
"model": "doubao-seedance-2-0-260128",
"prompt": "@Image1 里的机器人走进 @Image2 的老街,步态参考 @Video1,动作节奏跟随 @Audio1 的鼓点",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_urls": ["https://example.com/robot.png", "https://example.com/old-street.png"],
"video_urls": ["https://example.com/walk-cycle.mp4"],
"audio_urls": ["https://example.com/drums.mp3"]
}doubao-seedance-2-0-mini-260615 · 产品静物 · 最省
{
"model": "doubao-seedance-2-0-mini-260615",
"prompt": "@Image1 的产品在转盘上缓慢旋转一周,柔光,背景保持纯色,节奏跟随 @Audio1",
"duration": 6,
"resolution": "720p",
"aspect_ratio": "1:1",
"image_urls": ["https://example.com/product.png"],
"audio_urls": ["https://example.com/beat.mp3"]
}样片
下面的样片来自本站早前的 Seedance 2.5 / 2.0 线路,画面能力与现在的官方型号一致(同一底层模型),仅计费口径不同。
所有底图都是用 gpt-image-2.5-sunburst 出的(横版 2560×1440、竖版 1440×2560),再作为参考图交给视频模型,提示词只写运镜与动态。
文生视频样片
以上三条为 Seedance 2.5 文生视频,30 秒,早期样片没有音轨。
最后更新于