NewAPI 与 Sub2API 怎么选？

ChatGPT-Next-Web、Cherry Studio、LobeChat、Codex、Claude Code、自研应用……工具越多，API Key 越乱：每个工具配一把 Key，用量分散、成本看不清、换模型要挨个改配置。

NewAPI 和 Sub2API 是当前社区里最常被拿来解决这个问题的两个开源项目，名字只差几个字母，定位却完全不同。本文不堆概念，直接把两者放在同一张表里比对，再讲清「什么情况下该选谁」，最后告诉你怎么把上游统一接到火山方舟官方 API 和 Key。

一、一张表说清差异

二、NewAPI：把一堆渠道收进一个入口

2.1 它解决什么问题

你手上有多个上游渠道——火山方舟官方 API、其它兼容服务商、备用 Key……下游又有一堆工具要接入。NewAPI 的思路是：上游全部登记成「渠道」，下游统一走一个 /v1 入口。

2.2 核心能力

• 多渠道聚合：同一模型可挂多个渠道，支持权重分配与失败重试，单渠道故障不中断服务；
• 统一令牌体系：对外签发 sk-xxx 子令牌，可单独设置额度、可用模型、过期时间；
• 分组与限速：不同用户 / 团队分到不同分组，独立配额与速率；
• 用量与日志：每次调用的模型、Token、耗时、费用均有记录，成本可追溯到人和工具；
• 双协议出口：既提供 OpenAI 兼容的 /v1，也提供 Anthropic 兼容的 /v1/messages，Claude Code 这类工具可以直接指过来；
• 原生方舟渠道：内置「火山方舟（volcengine）」渠道类型，在「添加渠道」里选中它即自动对接方舟官方接口，只需填入方舟官方 Key 与模型 ID，不用自己拼 Base URL。

2.3 适合谁

• 团队共用：一个人配好渠道，其他人只领一把子 Key；
• 多工具重度用户：桌面端、编辑器插件、命令行 Agent 全部指向同一个地址；
• 需要成本核算：要看清「哪个项目、哪个人、用了多少钱」。

三、Sub2API：把订阅账号变成标准 API

3.1 它解决什么问题

很多能力的入口是「订阅制账号」，而不是 API。Sub2API 的思路是：在后台登记供应商 / 账号，对外输出一个标准 OpenAI 接口，让只认 OpenAI 协议的工具也能用上。

3.2 核心能力

• 供应商 / 账号管理：把上游账号集中登记，统一维护可用状态；
• 分组 + 模型白名单：一个分组对应一组模型，Key 绑定分组，避免下游乱用模型；
• 标准 OpenAI 出口：/v1/chat/completions，绝大多数工具开箱即用；
• 自带管理后台：账号、分组、Key、调用日志一目了然；
• 部署简单：一键脚本拉起 Docker Compose，几分钟可用。

3.3 适合谁

• 个人开发者，只想把上游快速转成 API 给一两个工具用；
• 上游只有一个（例如就接方舟官方 API），不需要复杂路由；
• 不想折腾渠道权重、倍率、重试策略这些「运营级」配置。

四、到底差在哪

4.1 架构思路不同

NewAPI 面向「运营」：渠道越多、用户越多，它越有价值。Sub2API 面向「转换」：把非 API 的入口，翻译成 API 出口。

4.2 协议兼容性不同

• NewAPI：OpenAI 兼容 + Anthropic 兼容双出口，Agent 类工具（Claude Code 等）可以直接对接；
• Sub2API：以 OpenAI 兼容出口为主，覆盖绝大多数聊天客户端与开发框架。

4.3 运维复杂度不同

• NewAPI：单容器部署，配置项偏多，但都集中在后台可视化完成；
• Sub2API：Compose 一键脚本，配置项更少，学习曲线更平缓。

4.4 成本管理能力不同

• NewAPI：能做到「令牌级」的成本归集，适合多人协作时做分摊；
• Sub2API：分组级统计，够用但不细。

4.5 相同点

两者的「骨架」是一致的：上游配置 + 分组 / 令牌 + 统一出口 + 调用日志。也因此，两款工具接入火山方舟官方 API 的方式几乎相同，只有配置项的入口名称不一样。

五、对号入座，按场景选

六、无论选哪个，上游都建议接火山方舟官方 API

这是全文最关键的一点：网关只是「管道」，模型能力与成本取决于上游。把上游接到字节跳动火山方舟的官方 API，下游才能稳定地用上 DeepSeek、GLM 等旗舰模型。

6.1 先分清地址：按量计费 ≠ 套餐地址

域名均为 ark.cn-beijing.volces.com

6.2 在网关里怎么填

NewAPI：后台「渠道」→「添加渠道」，类型直接选火山方舟（volcengine）——这是 NewAPI 原生内置的提供商渠道，选中即自动对接方舟官方接口。

Sub2API：后台「账号管理」→「添加账号」

配置完成后创建分组 / 令牌，下游统一填「网关地址 + 网关 Key」即可。

6.3 可用模型 ID（示例）

6.4 一条命令验证

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ark-你的Key" \
  -d '{
    "model": "deepseek-v4-1-flash-260910",
    "messages": [{"role": "user", "content": "你好"}]
  }'

能正常返回 JSON，说明官方 Key 已经打通，再把它填进 NewAPI / Sub2API 的上游即可。

七、选择向量云提供的火山方舟官方 API 和 Key

选好了网关，下一步是选 Key 的来源。向量云（南京）科技有限公司提供的就是字节跳动火山方舟的官方 API 和官方 Key——不是二手转发，也不是来路不明的聚合号池。

获取 Key 只需三步

1. 注册账号，完成首次充值 打开 https://ark.tokenrize.cn/ 注册并验证邮箱，前往「钱包充值」完成首次充值（不少于 10 元，余额实时到账）。
2. 创建 API Key，妥善保存 进入「API Key 管理」页面创建 Key，系统将自动分配一把方舟官方可用的 Key；请立即复制保存，弹窗关闭后完整 Key 不再展示。
3. 填进网关上游，链路即通 把 ark-... 格式的 Key 填进 NewAPI / Sub2API 的上游配置，下游工具统一指向网关地址即可。

八、总结

1. 看需求选网关：要团队协作、多渠道路由、双协议出口 → NewAPI；只想把上游快速转成 API 给少数工具用 → Sub2API；
2. 上游认准官方：NewAPI 添加渠道时直接选内置的火山方舟（volcengine）渠道即可；Sub2API 等走 OpenAI 兼容类型时，Base URL 填 https://ark.cn-beijing.volces.com/api/v3（OpenAI 兼容）或 .../api/compatible（Anthropic 兼容），别混用 coding / plan 套餐地址；
3. Key 从向量云拿：火山方舟官方 API 和 Key，低折扣 Token、按量计费、即用即扣、10 元起步，用量账单实时可查。

网关解决「怎么管」，官方 API 解决「好不好用」，向量云解决「贵不贵」。三件事各归其位，大模型调用这件事就清爽了。