Seedance 2.5 API 接入指南:模型 ID、开通门槛、Python 与 Node.js
Seedance 2.5 API 已在火山方舟和 BytePlus 开放,新账号要先满足 200 元或 USD 30 的开通门槛;2.0 代码不能只改模型 ID。
文章目录

截至 2026 年 10 月 22 日,Seedance 2.5 已经可以用 API 调用:中国大陆账号走火山方舟,模型 ID 是 doubao-seedance-2-5-260628;国际账号走 BytePlus ModelArk,模型 ID 是 dreamina-seedance-2-5-260628。两边的接口都是异步任务:POST /api/v3/contents/generations/tasks 创建,拿到 task ID 后再查询结果。
新账号最常见的卡点不是代码,而是模型还没开通。火山方舟要求账户可用余额达到 200 元,或买了 200 元及以上的节省计划、资源包;BytePlus 的门槛是 USD 30。另一个坑是把 2.0 的代码只改一个数字:2.5 的 duration 默认是 -1(模型自己决定 4–30 秒),首帧、编辑、延长任务的 ratio 只能是 adaptive,输出最高 1080p,没有 4K。
Seedance 2.5 没有公开模型权重,不能本地部署,只能通过 API 或即梦等应用使用。

图为 2026 年 8 月 4 日的判断流程;截至 2026 年 10 月 22 日,火山方舟和 BytePlus 的官方目录都已列出 Seedance 2.5 模型 ID,现状以正文为准。
Seedance 2.5 API 现在能用吗:火山方舟与 BytePlus 都已上线
能用。火山方舟的 Doubao Seedance 2.5 教程(页面显示最近更新于 2026 年 10 月 19 日)列出了 doubao-seedance-2-5-260628 以及 2.0、2.0 fast、2.0 mini 四个模型 ID;BytePlus ModelArk 的 Seedance 2.5 教程列出对应的 dreamina-* ID,BytePlus 创建视频任务 API 参考页首写着 Seedance 2.5 已全面开放、可以通过 API 调用。
时间线只记两点:Seedance 2.5 于 2026 年 7 月 31 日发布;API 开放日期没有第一方公告,第三方报道为 2026 年 8 月 7 日,最晚到 8 月下旬 BytePlus 文档里已经出现 2.5 的模型 ID。Seed 的 Seedance 2.5 发布文章里“API 服务也将在近期上线火山方舟”是发布当天的说法,之后没有改过,不代表现在还没开放。各个入口什么时候上线、现在能在哪里用,见 Seedance 2.5 已发布吗?入口、可用性与 API 状态:官方 API 已开放。
Seedance API 文档在哪里:火山方舟与 BytePlus 官方文档入口
接入只需要下面几页。火山方舟旧链接 docs/82379/1520757 现在会跳转到新的 docs/ark/... 路径,收藏时用新地址。
| 要查的内容 | 火山方舟(中国区) | BytePlus ModelArk(国际区) |
|---|---|---|
| 2.5 模型 ID、能力、参数限制、示例代码 | Doubao Seedance 2.5 教程 | Dreamina Seedance 2.5 tutorial |
| 创建任务的全部请求字段 | 火山方舟创建视频生成任务 API | BytePlus Create video generation task API |
| 查询任务与返回字段 | 火山方舟查询视频生成任务 API | 同上一行的 BytePlus API 参考目录 |
| 开通条件、抵扣顺序、退订 | 火山方舟 Seedance 模型开通、使用与退订说明 | BytePlus Seedance 模型开通与退订说明 |
| 错误码 | 火山方舟错误码 | API 参考里的错误说明 |
| 能否注册 | 中国大陆实名账号 | BytePlus 可用国家和地区列表 |
两个教程页的“准备工作”顺序相同:注册并登录 → 在 API Key 管理页创建 API Key → 在开通管理里开通模型 → 发请求。官方示例用的是 arkruntime Python SDK;下面的代码直接发 HTTP 请求,字段名相同,不需要装 SDK。
先选接入路线:地址、API Key、模型 ID 与开通门槛整组配置
一条路线由四样东西组成:Base URL、在该平台创建的 API Key、该平台命名空间下的模型 ID、接口路径。四样必须来自同一个平台,拆开混用会得到 401、404 或“模型不存在”。
| 路线 | Base URL | API Key 从哪来 | 2.5 模型 ID | 2.0 系列模型 ID | 开始调用前 |
|---|---|---|---|---|---|
| 火山方舟直连 | https://ark.cn-beijing.volces.com/api/v3 | 火山方舟控制台的 API Key 管理 | doubao-seedance-2-5-260628 | doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615 | 实名认证;余额达到 200 元或有 200 元及以上节省计划 / 资源包,再在开通管理里开通模型 |
| BytePlus ModelArk 直连 | https://ark.ap-southeast.bytepluses.com/api/v3 | ModelArk 控制台的 API Key 管理 | dreamina-seedance-2-5-260628 | dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini-260615 | 账号所在国家或地区在可用列表内;Credits 达到 USD 30 或有 USD 30 及以上 AI Savings Plan / 资源包,再开通模型 |
| laozhang.ai 中转 | https://api.laozhang.ai/seedance/api/v3 | laozhang.ai 令牌,分组必须是 SeeDance2 | doubao-seedance-2-5-260628 | 与火山方舟相同的三个 doubao-* ID | 令牌分组正确、账户有余额 |
| 其他第三方平台 | 各平台自己的地址 | 各平台自己的 Key | 各平台自定,例如 OpenRouter 和 Replicate 用 bytedance/seedance-2.5 | 各平台自定 | 按该平台文档;分辨率、时长和人脸规则可能与官方不同 |
说明:laozhang.ai 是我们自己的服务,其价格是平台报价,不是独立比较的结论。
怎么选:
- 公司主体和用户都在中国大陆:用火山方舟。BytePlus 的可用国家和地区列表不含中国大陆,大陆账号不要去注册 BytePlus。
- 公司或用户在海外、需要美元结算:用 BytePlus。注册前先看可用国家和地区列表,列表不含中国大陆、俄罗斯、美国和印度,最终以购买时的判定为准。
- 不想在官方平台各自开户、预充门槛,只想用一个 Key 调多种模型:可以走中转(下面单独一节)。
- 已经在用某个第三方平台:只在该平台内整套使用它的 ID 和地址,不要把它的 ID 带到官方地址上。
dreamina-* 只在 BytePlus 有效,doubao-* 只在火山方舟和沿用火山 ID 的中转上有效。所谓“Seedance API 文档”,要能同时回答这四样:地址、Key、模型 ID、路径。
新账号调不通,先看是否开通模型:200 元与 USD 30
拿到 API Key 不等于能调 Seedance。两家都要求先开通模型,开通前必须满足下面任一条件,条件对 2.5、2.0、2.0 mini、2.0 fast 通用;满足后到控制台的“开通管理”里开通你要调用的模型。
| 条件 | 火山方舟 | BytePlus |
|---|---|---|
| 账户余额(官方推荐) | 账户可用余额达到 200 元,无有效期 | 已认证的 Credits 用户,Credits 达到 USD 30,无有效期 |
| 节省计划(官方推荐) | 200 元及以上的专属递减型节省计划且有余额;200 元档 30 天,500 元、1000 元档 90 天 | USD 30 及以上的专属递减型 AI Savings Plan 且有余额;USD 30 档 1 个月,USD 60、USD 100 档 3 个月 |
| 资源包 | 200 元及以上的模型资源包且有余量,90 天,只抵扣对应模型 | USD 30 及以上的资源包且有余量,90 天,只抵扣对应模型 |
| 钱能不能退 | 模型开通期间,余额里不超过 200 元的部分不能提现,关闭模型实例后可以提现;节省计划和资源包购买超过 7 天或已使用就不能退订 | Credits 买了不能提现;节省计划和资源包不能退订 |
开通后按 token 计费,抵扣顺序是资源包 → 节省计划 → 账户余额。新用户的免费推理额度用完后调用会直接失败,在火山方舟还要完成实名认证并开通模型才能继续。这是账号状态问题,换提示词、换网络、重试都没用;先读响应里的 error.code,再到开通管理里看模型状态。
Seedance 2.5 没有公开的免费 API 额度。两家的模型列表在视频生成模型下都没有列免费额度,不要按“新用户送 token”来规划测试预算。价格方面,按官方价格表,2.5 输出 720p、16:9 大约每秒 ¥1.51(火山方舟),只对成功生成的视频计费;各渠道的每秒价对比见 Seedance 2.5 API 价格:各渠道每秒价对比,免费额度够不够。
从 2.0 迁移到 2.5:不能只改模型 ID
请求格式相同,但 2.5 的默认值和限制变了。直接把 doubao-seedance-2-0-260128 换成 doubao-seedance-2-5-260628,文生视频多半能跑,首帧、编辑、延长任务会报参数错误,时长和费用也可能和预期不一样。
| 项目 | Seedance 2.0 系列 | Seedance 2.5 |
|---|---|---|
duration | 4–15 秒,或 -1 | 4–30 秒,默认 -1(模型自选时长,费用跟着变) |
ratio 默认值 | 见 2.0 系列教程 | adaptive |
| 首帧 / 首尾帧生视频 | — | ratio 必须是 adaptive |
| 视频编辑 | — | ratio 必须是 adaptive、duration 必须是 -1;参考视频 4–30 秒 |
| 视频延长 | — | ratio 必须是 adaptive |
| 参考素材上限 | 15 个(9 图 + 3 视频 + 3 音频) | 50 个(30 图 + 10 视频 + 10 音频) |
| 只用音频做参考 | 不行,需要搭配图片或视频 | 可以 |
| 输出分辨率 | 2.0:480p、720p、1080p、4k;fast 和 mini:480p、720p | 480p、720p、1080p(10 bit),没有 4k |
output_format | mp4 | mp4(默认)或 mov |
| 样片(Draft)模式 | 不支持 | 支持,先出 480p 样片再出 1080p 成片,两步分别计费 |
| 新字段 | — | omni_reference_task_type:auto(默认)、reference、edit、extend |
表中“—”表示这是 2.5 新增的限制或字段。
迁移时逐项处理:
- 显式传
duration。 不传就是-1,模型可能生成 4 秒也可能生成 30 秒,费用按实际时长算。 - 按任务类型设
ratio。 文生视频、普通参考生视频可以指定16:9等比例;首帧、首尾帧、编辑、延长一律写adaptive。 - 去掉
4k。 2.5 最高 1080p。一些第三方页面写着 2.5 支持“原生 4K”,那是平台自己的放大流程,官方模型表里没有 4k。 - mov 先确认播放环境。 mov 是 H.264 + yuv444p + PCM 音频,适合剪辑和调色,网页和部分播放器打不开,面向终端用户时保留 mp4。
- 编辑和延长写清意图。 参考视频加上
omni_reference_task_type为edit或extend,提示词里用@视频1指明处理哪一段;提示词写法见 Seedance 2 提示词指南:分镜、参考素材与 2.5 编辑示例。
用官方 Python SDK 时,omni_reference_task_type、output_format 这类新字段在官方示例里放在 extra_body 中;直接发 HTTP 请求时它们和 ratio、duration 同级。
火山方舟 Seedance API 上传图片:URL、Base64 与素材 ID
图片、视频、音频都放在 content 数组里,每一项用 role 说明用途。图片可以用公网 URL、Base64 编码或素材 ID 传入:
{
"type": "image_url",
"image_url": { "url": "https://example.com/product.png" },
"role": "first_frame"
}role 的取值决定任务类型:first_frame(首帧,1 张)、first_frame + last_frame(首尾帧,2 张)、reference_image(参考图,2.5 最多 30 张)。视频用 video_url + reference_video,音频用 audio_url + reference_audio。首尾帧模式和多模态参考不要写进同一个请求。
2.5 的输入限制:
| 素材 | 传入方式 | 格式 | 大小与数量 |
|---|---|---|---|
| 图片 | URL、Base64、素材 ID | jpeg、png、webp、bmp、tiff、gif、heic、heif | 单张小于 30 MB,宽高 300–6000 px,宽高比 0.4–2.5 |
| 视频 | URL、素材 ID(不支持 Base64) | mp4、mov | 单个不超过 200 MB;最多 10 个,总时长不超过 30 秒 |
| 音频 | URL、Base64、素材 ID | wav、mp3 | 单段 2–30 秒、不超过 15 MB;最多 10 段,总时长不超过 30 秒 |
整个请求体不能超过 64 MB,大文件不要用 Base64,先传到对象存储再给 URL。Base64 的具体写法照官方教程里的示例格式,不要自己拼前缀。
真人脸不能直接上传。 Seedance 2.5 和 2.0 一样,不接受含真人人脸的参考图或参考视频,会在创建任务时被拦下。官方给的路线是:同一账号下模型生成的人脸产物、平台预置的虚拟人像、已授权的真人素材。具体报错和处理见 Seedance 提示“输入图片可能包含真人”:2.5 人脸限制与正确处理。
中国区最小 API 调用
下面示例只适用于火山方舟(中国区)的 Seedance 2.5。创建接口只返回 task ID,不会同步返回视频:
curl -X POST \
"https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
-H "Authorization: Bearer $ARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-5-260628",
"content": [{
"type": "text",
"text": "安静的桌面产品镜头,缓慢推进,自然环境声"
}],
"ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true,
"callback_url": "https://api.example.com/webhooks/seedance"
}'换成 BytePlus 时只改两处:地址换成 https://ark.ap-southeast.bytepluses.com/api/v3,模型换成 dreamina-seedance-2-5-260628,Key 用 BytePlus 控制台创建的那一个。
提交前先在本地写入 job 和规范化后的请求哈希;收到响应后立刻保存 task ID。job 至少绑定路线、模型、用户、提示词与素材指纹和输出参数。
查询时继续使用同一套地址和 Key:
curl \
"https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/$TASK_ID" \
-H "Authorization: Bearer $ARK_API_KEY"| 状态 | 含义 | 下一步 |
|---|---|---|
queued | 已受理,排队中 | 等回调或稍后查询,不要创建替代任务 |
running | 正在生成 | 继续持有同一个 task ID |
succeeded | 视频已生成 | 原子更新状态并转存视频 |
failed | 上游以错误结束 | 保存 error,分类后再决定是否新建 |
expired | 超过执行时限(execution_expires_after 默认 172800 秒,即 48 小时) | 记录终态,不自动重复生成 |
content.video_url 只保存 24 小时、最多下载 100 次,到期就打不开;任务记录保存 7 天。成功后尽快复制到自己的对象存储,复制失败可以重试,但不要重新生成。任务一直卡在排队、失败或超时,按 Seedance 2.5 报错、排队和超时排查:先确认任务是否受理 逐项查。
用响应状态和 Content-Type 先排除错路径
2026 年 10 月 21 日从中国大陆网络发出不带 Key、请求体为 {} 的 POST,结果如下(没有创建任何生成任务):
| 请求地址 | 返回 | 能说明什么 |
|---|---|---|
BytePlus https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks | HTTP 401 JSON,AuthenticationError | 路径对,缺 Key;不能说明模型已开通 |
火山方舟 https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks | HTTP 401 JSON,AuthenticationError | 路径对,缺 Key |
laozhang.ai https://api.laozhang.ai/seedance/api/v3/contents/generations/tasks | HTTP 401 JSON,Invalid token | 路径对,等待正确令牌 |
laozhang.ai 少了 /seedance 的 /api/v3/contents/generations/tasks | HTTP 404 JSON,Invalid URL | 路径错 |
laozhang.ai 旧路径 /seedance/v3/contents/generations/tasks | HTTP 200 text/html | 打到了网页,不是 API 成功 |
说明:laozhang.ai 是我们自己的服务,其价格是平台报价,不是独立比较的结论。
健康检查要同时判断状态码和 Content-Type:401 application/json 只说明请求到了鉴权这一层;200 text/html 一律判错。这组结果只证明路径和鉴权边界,不代表账号能生成视频。
创建并保护 API Key
官方直连时,在目标平台和区域里创建 Key:火山方舟在控制台的“API Key 管理”,BytePlus 在 ModelArk 的 API Key 管理页(操作说明见 BytePlus ModelArk 的 API Key 管理文档)。不要拿另一个账号或区域的开通状态来推断当前 Key 能用。
Key 只放服务端环境变量,不写进网页 JavaScript、客户端安装包、Git 仓库或回调地址。
export SEEDANCE_API_KEY="仅放服务端"
export SEEDANCE_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"
export SEEDANCE_MODEL="doubao-seedance-2-5-260628"启动时把三项作为一个配置对象校验:
function assertRoute(baseUrl: string, model: string, key: string) {
if (!key) throw new Error("缺少服务端 API Key");
const bytePlus = baseUrl.includes("bytepluses.com");
const china = baseUrl.includes("volces.com");
const relay = baseUrl.includes("api.laozhang.ai");
if (relay && !baseUrl.endsWith("/seedance/api/v3")) {
throw new Error("laozhang.ai 的地址必须是 https://api.laozhang.ai/seedance/api/v3");
}
if (bytePlus && !model.startsWith("dreamina-seedance-")) {
throw new Error("BytePlus 必须使用 dreamina-* 模型 ID");
}
if ((china || relay) && !model.startsWith("doubao-seedance-")) {
throw new Error("火山方舟和 laozhang.ai 必须使用 doubao-* 模型 ID");
}
}这个检查只能挡住地址与模型 ID 配错,不能代替真实的鉴权和开通检查。
用 Python 提交一次并轮询同一个任务
下面代码用 requests 直接调用接口,三个环境变量换成哪条路线的值就调哪条路线。它创建一个 5 秒的文生视频,轮询到终态,成功后马上下载。
import os
import time
import requests
base_url = os.environ["SEEDANCE_BASE_URL"].rstrip("/")
api_key = os.environ["SEEDANCE_API_KEY"]
model = os.environ["SEEDANCE_MODEL"] # 例如 doubao-seedance-2-5-260628
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"model": model,
"content": [{"type": "text", "text": "雨后街道上的产品镜头,缓慢推进,自然环境声"}],
"ratio": "16:9", # 2.5 默认 adaptive;首帧、编辑、延长任务只能用 adaptive
"resolution": "720p", # 2.5 最高 1080p,没有 4k
"duration": 5, # 2.5 默认 -1,由模型在 4–30 秒内自选,费用随之变化
"generate_audio": True,
}
created = requests.post(
f"{base_url}/contents/generations/tasks",
headers=headers,
json=payload,
timeout=30,
)
created.raise_for_status()
task_id = created.json()["id"] # 立即保存到数据库
while True:
task = requests.get(
f"{base_url}/contents/generations/tasks/{task_id}",
headers=headers,
timeout=30,
)
task.raise_for_status()
data = task.json()
if data["status"] not in {"queued", "running"}:
break
time.sleep(10)
# completed 只会出现在 laozhang.ai 中转的兼容任务对象里,含义同 succeeded
if data["status"] in {"succeeded", "completed"}:
video_url = data["content"]["video_url"] # 24 小时内有效
with requests.get(video_url, stream=True, timeout=120) as video:
video.raise_for_status()
with open(f"{task_id}.mp4", "wb") as f:
for chunk in video.iter_content(chunk_size=1 << 20):
f.write(chunk)
else:
print("任务结束但未成功:", data["status"], data.get("error"))POST 超时、没拿到 task ID 时,不要自动再发一次。上游可能已经受理了任务;把本地 job 标记为“提交结果未知”,先用回调、请求日志或平台的任务列表对账。
用 Node.js 跑同一套创建、轮询与下载流程
Node.js 18 及以上版本可以直接用 fetch。同样只从服务端环境变量读取配置,不把 Key 放进浏览器或移动端。
import { writeFile } from "node:fs/promises";
const baseUrl = process.env.SEEDANCE_BASE_URL.replace(/\/$/, "");
const apiKey = process.env.SEEDANCE_API_KEY;
const model = process.env.SEEDANCE_MODEL;
const request = async (path, init = {}) => {
const response = await fetch(`${baseUrl}${path}`, {
...init,
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
...init.headers,
},
});
const type = response.headers.get("content-type") || "";
if (!type.includes("application/json")) throw new Error(`预期 JSON,实际为 ${type}`);
const data = await response.json();
if (!response.ok) throw new Error(`${response.status}: ${JSON.stringify(data)}`);
return data;
};
const created = await request("/contents/generations/tasks", {
method: "POST",
body: JSON.stringify({
model,
content: [{ type: "text", text: "一只陶瓷杯在干净的摄影台上缓慢旋转" }],
ratio: "16:9",
resolution: "720p",
duration: 5, // 不传就是 -1,时长和费用由模型决定
generate_audio: true,
}),
});
const taskId = created.id; // 继续之前先持久化
let task;
for (;;) {
task = await request(`/contents/generations/tasks/${taskId}`);
if (!["queued", "running"].includes(task.status)) break;
await new Promise((resolve) => setTimeout(resolve, 10000));
}
if (["succeeded", "completed"].includes(task.status)) {
const video = await fetch(task.content.video_url); // 签名地址,不需要再带 Key
await writeFile(`${taskId}.mp4`, Buffer.from(await video.arrayBuffer()));
} else {
console.error("任务结束但未成功:", task.status, task.error);
}
callback 与轮询要写回同一个 job
回调地址(callback_url)是可选字段。BytePlus 创建视频任务 API 参考说明,回调的请求体和查询任务的返回格式相同;任务进入终态的通知如果 5 秒内没有得到确认,会重试 3 次。接火山方舟或第三方平台时,以该平台创建任务文档里的回调说明为准。
所以回调处理必须幂等:按 task ID 找到本地 job;确认它属于预期的路线和业务用户;同样的状态重复到达直接忽略;终态不能回退到 running;成功后只入队一次“转存视频”。再为等不到回调、仍未到终态的 job 跑一个轮询修复任务,调用 GET .../tasks/{id},复用同一个状态迁移函数。
官方文档没有给出回调签名方案,不要自己假设签名字段。实现上强制 HTTPS、限制请求体大小和 Content-Type、校验 task 归属,状态写库后尽快返回 2xx。
const terminal = new Set(["succeeded", "failed", "expired"]);
async function applyState(event) {
const job = await jobs.findByProviderTaskId(event.id);
if (job == null) throw new Error("未知的 task ID");
await jobs.transaction(async (tx) => {
const current = await tx.forUpdate(job.id);
if (current.providerStatus === event.status) return;
if (terminal.has(current.providerStatus)) return;
await tx.update(job.id, { providerStatus: event.status });
if (event.status === "succeeded") await tx.enqueueOutputCopy(job.id);
});
}创建超时必须触发 duplicate-create stop rule
最危险的情况是:上游已经受理了创建请求,客户端却在拿到 task ID 之前超时。
停止规则:只要本地 job 可能已经到达平台,就不能因为 HTTP 超时再发第二个 POST。先按请求哈希、task ID、请求日志和回调对账;已有 ID 就继续查询;仍不确定是否受理时,显示“提交状态未知”,交给用户或运维确认,不要悄悄再付一次生成费。
| 操作 | 重试规则 |
|---|---|
| 请求还没离开进程 | 可以首次提交 |
| 创建超时、不知道是否受理 | 停止,先对账 |
| 已有 task ID 的查询 | 网络错误和 5xx 可以有限退避重试 |
| 回调处理 | 靠幂等状态迁移,可重复执行 |
| 成功视频转存 | 可以重试复制,不能重新生成 |
| 创建时返回 429 | 触发了每分钟创建上限,退避后再提交;这时任务确实没被受理 |
返回 failed | 先区分参数、内容审核、账号开通、额度和临时错误 |
限流与保留期:RPM、并发和 24 小时下载窗口
两家的限制相同,按同一主账号、同一模型系列(不分版本)计算:
| 项目 | 企业用户 | 个人用户 |
|---|---|---|
| 每分钟可创建任务数(RPM) | 600 | 180 |
| 同时处理的任务数(并发) | 10 | 3 |
超过 RPM 时创建请求直接失败,返回 429;并发满了,新任务会进入队列等待,状态停在 queued,这不是故障。火山方舟查询单个任务的接口按账号限制为每秒 20 次,轮询间隔 10 秒左右足够。视频地址 24 小时后失效,任务记录保留 7 天。
Standard、Fast、Mini 与 priority 的边界
四个模型都可以在两家官方平台调用:2.5、2.0(Standard)、2.0 fast、2.0 mini。选择上:
- 需要超过 15 秒的成片、更多参考素材、只用音频做参考、样片模式或 mov 输出:用 2.5。
- 需要 4k 输出:只有 2.0 Standard 支持。
- 成本优先、720p 够用:2.0 fast 或 2.0 mini,二者最高 720p、4–15 秒。
BytePlus 创建接口为 Seedance 2.0 记录了 priority(0–9),只在同一 endpoint 的在线推理里让排队中的任务优先被处理,不会打断正在生成的任务,不跨 endpoint 排队,也不是“生成加速”开关;文档没有说明它对 2.5 生效。
Seedance API 中转:laozhang.ai 的地址、分组与路径
laozhang.ai 的 Seedance 2.0 与 2.5 视频生成 API 文档采用火山方舟的请求格式和 doubao-* 模型 ID,四个模型都在列表里。接入时注意这几点:
说明:laozhang.ai 是我们自己的服务,其价格是平台报价,不是独立比较的结论。
- 地址:
https://api.laozhang.ai/seedance/api/v3。不要把官方的/api/v3/...直接接在https://api.laozhang.ai后面(会返回 404Invalid URL),也不要少写/api(/seedance/v3/...返回的是网页)。 - 令牌分组:令牌必须在
SeeDance2分组,default等其他分组调用会报“无可用渠道”。 - 状态:轮询时
succeeded和completed都表示成功;视频地址在content.video_url,也可以用GET https://api.laozhang.ai/v1/videos/{id}/content下载。 - 参数:传
4k会立刻返回 400,不扣费;duration默认-1,要控制成本就显式传入。 - 计费与对账:按 token 计费,每个任务在调用日志里有预扣和结算两条记录,二者合计才是这个任务的费用;具体单价看平台报价页。
需要在视频里使用真人或固定虚拟人形象时,文档另有真人与虚拟人素材流程:先建素材,等状态变成 Active,再把返回的 asset://... 作为 reference_image 放进普通的 Seedance 任务。这个能力需要账号单独开通,未开通时返回 403 capability_unavailable;文档示例用的是 2.0 模型 ID。
其他第三方平台的模型名、分辨率上限、计费和人脸规则各不相同,选服务商可以参考 Seedance 2.0 API 服务商怎么选:Kie、OpenRouter 与第三方路线对比,那篇写于 2.0 阶段,2.5 的支持情况以各平台当前文档为准。
Seedance 2.5 API 上线前检查清单
- 地址、Key、模型 ID、路径来自同一个平台,并作为一个配置整体版本化
- 账号已开通对应模型:火山方舟余额达到 200 元或有对应节省计划 / 资源包,BytePlus 达到 USD 30
- 2.5 请求显式传
duration;首帧、编辑、延长任务的ratio是adaptive;没有4k - 参考素材不含真人脸,大文件走 URL 而不是 Base64,请求体不超过 64 MB
- task ID 先保存再轮询;回调幂等,轮询可以补漏
- 创建超时不会自动产生第二个任务;429 按限流退避
- 视频在 24 小时内转存到自己的存储
- 健康检查拒绝 HTML 响应
- Key 只在服务端;
priority没被当作速度保证
Seedance 2.5 API 常见问题
Seedance 2.5 API 免费吗?
没有公开的免费额度。火山方舟和 BytePlus 给新用户的免费推理额度按模型计算,但两家模型列表的视频生成部分都没有列出 Seedance 的免费额度;正式调用前还要先满足 200 元或 USD 30 的开通门槛。
Seedance 2.0 的代码能直接改成 2.5 吗?
请求结构能沿用,但不能只改模型 ID。2.5 的 duration 默认 -1,ratio 默认 adaptive,首帧、首尾帧、编辑、延长任务要求 ratio 为 adaptive,编辑还要求 duration 为 -1;2.5 也不支持 4k。
Seedance 接口可以用吗?在哪里申请?
可以。中国大陆账号在火山方舟控制台实名认证、创建 API Key、在开通管理里开通 Seedance 2.5;海外账号在 BytePlus ModelArk 做同样的步骤。两边都要先满足余额或套餐门槛。
Seedance 2.5 能本地部署吗?
不能。Seedance 2.5 没有公开模型权重,只能通过火山方舟、BytePlus 等平台的 API,或即梦、豆包等应用使用。
参考来源11
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月22日。
参考来源11
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月22日。
- 1.火山方舟的 Doubao Seedance 2.5 教程docs.volcengine.com/docs/ark/seedance-2-5
- 2.BytePlus ModelArk 的 Seedance 2.5 教程docs.byteplus.com/en/docs/modelark/seedance-2-5
- 3.BytePlus 创建视频任务 API 参考docs.byteplus.com/en/docs/modelark/create-video-generation-task-api
- 4.Seed 的 Seedance 2.5 发布文章seed.bytedance.com/zh/blog/one-take-creation-flexible-referencing-introducing-seedance-2-5
- 5.火山方舟创建视频生成任务 APIdocs.volcengine.com/docs/ark/create-video-generation-task-api
- 6.火山方舟查询视频生成任务 APIdocs.volcengine.com/docs/ark/get-video-generation-task-api
- 7.火山方舟 Seedance 模型开通、使用与退订说明docs.volcengine.com/docs/ark/seedance-model-activation-usage-and-refund
- 8.BytePlus Seedance 模型开通与退订说明docs.byteplus.com/en/docs/modelark/seedance-model-activation-usage-and-refund
- 9.火山方舟错误码docs.volcengine.com/docs/ark/error-codes
- 10.BytePlus 可用国家和地区列表docs.byteplus.com/en/docs/modelark/availability
- 11.BytePlus ModelArk 的 API Key 管理文档docs.byteplus.com/en/docs/modelark/manage-api-keys





