跳转到主要内容

Seedance 2.5 API 接入指南:模型 ID、开通门槛、Python 与 Node.js

Seedance 2.5 API 已在火山方舟和 BytePlus 开放,新账号要先满足 200 元或 USD 30 的开通门槛;2.0 代码不能只改模型 ID。

LaoZhang AI Team发布于更新于 25 分钟阅读
文章目录
Seedance 2.5 API 接入路线:火山方舟与 BytePlus 的地址、API Key、模型 ID 配成一组,再用 Python 和 Node.js 创建并轮询视频任务

截至 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 或即梦等应用使用。

Seedance 2.5 产品发布、官方 API 目录与第三方 provider 路线的状态关系

图为 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
创建任务的全部请求字段火山方舟创建视频生成任务 APIBytePlus 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 URLAPI Key 从哪来2.5 模型 ID2.0 系列模型 ID开始调用前
火山方舟直连https://ark.cn-beijing.volces.com/api/v3火山方舟控制台的 API Key 管理doubao-seedance-2-5-260628doubao-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/v3ModelArk 控制台的 API Key 管理dreamina-seedance-2-5-260628dreamina-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/v3laozhang.ai 令牌,分组必须是 SeeDance2doubao-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
duration4–15 秒,或 -14–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、720p480p、720p、1080p(10 bit),没有 4k
output_formatmp4mp4(默认)或 mov
样片(Draft)模式不支持支持,先出 480p 样片再出 1080p 成片,两步分别计费
新字段—omni_reference_task_type:auto(默认)、reference、edit、extend

表中“—”表示这是 2.5 新增的限制或字段。

迁移时逐项处理:

  1. 显式传 duration。 不传就是 -1,模型可能生成 4 秒也可能生成 30 秒,费用按实际时长算。
  2. 按任务类型设 ratio。 文生视频、普通参考生视频可以指定 16:9 等比例;首帧、首尾帧、编辑、延长一律写 adaptive。
  3. 去掉 4k。 2.5 最高 1080p。一些第三方页面写着 2.5 支持“原生 4K”,那是平台自己的放大流程,官方模型表里没有 4k。
  4. mov 先确认播放环境。 mov 是 H.264 + yuv444p + PCM 音频,适合剪辑和调色,网页和部分播放器打不开,面向终端用户时保留 mp4。
  5. 编辑和延长写清意图。 参考视频加上 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 传入:

json
{
  "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、素材 IDjpeg、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、素材 IDwav、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,不会同步返回视频:

bash
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:

bash
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/tasksHTTP 401 JSON,AuthenticationError路径对,缺 Key;不能说明模型已开通
火山方舟 https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasksHTTP 401 JSON,AuthenticationError路径对,缺 Key
laozhang.ai https://api.laozhang.ai/seedance/api/v3/contents/generations/tasksHTTP 401 JSON,Invalid token路径对,等待正确令牌
laozhang.ai 少了 /seedance 的 /api/v3/contents/generations/tasksHTTP 404 JSON,Invalid URL路径错
laozhang.ai 旧路径 /seedance/v3/contents/generations/tasksHTTP 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 仓库或回调地址。

bash
export SEEDANCE_API_KEY="仅放服务端"
export SEEDANCE_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"
export SEEDANCE_MODEL="doubao-seedance-2-5-260628"

启动时把三项作为一个配置对象校验:

ts
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 秒的文生视频,轮询到终态,成功后马上下载。

python
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 放进浏览器或移动端。

js
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);
}

Python 与 Node.js 共用的 Seedance 异步创建、保存 task ID、轮询和结果转存流程

callback 与轮询要写回同一个 job

回调地址(callback_url)是可选字段。BytePlus 创建视频任务 API 参考说明,回调的请求体和查询任务的返回格式相同;任务进入终态的通知如果 5 秒内没有得到确认,会重试 3 次。接火山方舟或第三方平台时,以该平台创建任务文档里的回调说明为准。

所以回调处理必须幂等:按 task ID 找到本地 job;确认它属于预期的路线和业务用户;同样的状态重复到达直接忽略;终态不能回退到 running;成功后只入队一次“转存视频”。再为等不到回调、仍未到终态的 job 跑一个轮询修复任务,调用 GET .../tasks/{id},复用同一个状态迁移函数。

官方文档没有给出回调签名方案,不要自己假设签名字段。实现上强制 HTTPS、限制请求体大小和 Content-Type、校验 task 归属,状态写库后尽快返回 2xx。

ts
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)600180
同时处理的任务数(并发)103

超过 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 后面(会返回 404 Invalid 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日。

  1. 1.火山方舟的 Doubao Seedance 2.5 教程docs.volcengine.com/docs/ark/seedance-2-5
  2. 2.BytePlus ModelArk 的 Seedance 2.5 教程docs.byteplus.com/en/docs/modelark/seedance-2-5
  3. 3.BytePlus 创建视频任务 API 参考docs.byteplus.com/en/docs/modelark/create-video-generation-task-api
  4. 4.Seed 的 Seedance 2.5 发布文章seed.bytedance.com/zh/blog/one-take-creation-flexible-referencing-introducing-seedance-2-5
  5. 5.火山方舟创建视频生成任务 APIdocs.volcengine.com/docs/ark/create-video-generation-task-api
  6. 6.火山方舟查询视频生成任务 APIdocs.volcengine.com/docs/ark/get-video-generation-task-api
  7. 7.火山方舟 Seedance 模型开通、使用与退订说明docs.volcengine.com/docs/ark/seedance-model-activation-usage-and-refund
  8. 8.BytePlus Seedance 模型开通与退订说明docs.byteplus.com/en/docs/modelark/seedance-model-activation-usage-and-refund
  9. 9.火山方舟错误码docs.volcengine.com/docs/ark/error-codes
  10. 10.BytePlus 可用国家和地区列表docs.byteplus.com/en/docs/modelark/availability
  11. 11.BytePlus ModelArk 的 API Key 管理文档docs.byteplus.com/en/docs/modelark/manage-api-keys
429 RESOURCE_EXHAUSTED 的停止条件与短时限流有限重试分流
故障排查

Nano Banana Pro RESOURCE_EXHAUSTED 429:排查与 Python、Node.js 恢复代码

Nano Banana Pro 的 429 不能一律靠重试解决:零额度、每日上限和计费阻塞应先停止,短时限流才按服务端最低等待时间重试。下面的 Python、Node.js 程序限制次数与请求等待总时长,验证并保存图片,续跑时跳过已确认完成的任务。

18 分钟