登录
开发者文档

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.mp4
import 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-260628doubao-seedance-2-0-260128doubao-seedance-2-0-fast-260128doubao-seedance-2-0-mini-260615
时长4–30 秒4–15 秒4–15 秒4–15 秒
分辨率720p · 1080p720p · 1080p720p720p
参考图最多 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 实测可以通过,但官方仍标注不保证,接入时预留一次重试。

参数

参数类型说明
modelstring四个官方模型 ID 之一
promptstring描述画面与运镜;引用参考素材用 @Image1 / @Video1 / @Audio1 这样的编号
durationnumber秒。2.5 为 4–30,2.0 系列为 4–15;不传按 5 秒。每一秒都计费,别再习惯性用满
resolutionstring720p(默认)或 1080p;1080p 只有 2.5 和 2.0 标准版有。480p / 4k 不开放,传了 400
aspect_ratiostring16:9 4:3 1:1 3:4 9:16 21:9,或 adaptive(跟随首帧 / 参考视频);不传时上游按素材自适应,纯文生视频默认 16:9
image_urlsstring[]参考图直链数组,上限见上表;等价写法 images
video_urlsstring[]参考视频直链数组,mp4 / mov,单条 2–30 秒(2.0 系列 2–15 秒),≤ 200 MB
audio_urlsstring[]参考音频直链数组,wav / mp3,单段 2–30 秒(2.0 系列 2–15 秒),≤ 15 MB
reference_imagesobject[][{url, role}],role 取 reference_image / first_frame / last_frame;首尾帧只能走这个字段
input_referencestring单张图作首帧,等价于 reference_images: [{url, role: "first_frame"}]
generate_audioboolean是否生成同步音轨,默认 true。当前传 false 不生效,成片总带音轨(2026-09-21 实测),要无声自己去掉音轨
watermarkboolean是否加水印,默认 false
seednumber随机种子,同种子同提示词结果接近
omni_reference_task_typestring仅 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.52.02.0 Fast2.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 · 10 s
美妆 · 香水花瓣 · Seedance 2.5 · 10 s
汽车 · 海岸公路 · Seedance 2.5 · 10 s
饮品 · 冰块入杯 · Seedance 2.5 · 10 s
运动鞋 · 雨夜悬浮 · Seedance 2.5 · 10 s
珠宝 · 钻戒微距 · Seedance 2.5 · 10 s
3C · 耳机爆炸图合体 · Seedance 2.0 · 8 s
珠宝 · 钻戒微距 · Seedance 2.0 · 8 s

文生视频样片

鲲鹏水墨
女娲补天
敦煌飞天

以上三条为 Seedance 2.5 文生视频,30 秒,早期样片没有音轨。

最后更新于