sub2api 是个开源的 API 网关:往它的号池里放上游账号(开了会员的订阅号,或者免费的普号),它把这些账号变成对外分发的 API Key。装起来不难,难的是号从哪来、能撑多久。这页只讲号这一侧——要什么号、什么格式能导入、在哪买、封号和条款的风险落在哪。
更新于 2026-10-27
sub2api 是什么
一句话:把「按月卖的订阅账号」变成「按用量卖的 API Key」的那层中间件。你放一批号进号池,它对外给出一组 API Key,按 token 记用量和账、限并发、绑会话(同一段对话尽量固定走同一个号)、自带一套充值付款的后台。它主要接入的是账号:有的走官方 OAuth 流程授权,有的要账号密码这类登录材料;少数按 Key 计的厂商也能直接填 API Key。
和只转发 Key 的那类网关相比,多出来的活全在号上:号从哪来、能撑多久,直接决定这套东西能不能长期跑。
和 new-api、one-api 不是一类东西
名字都带「API 网关」,但它们解决的是两个问题:
| 对比项 | new-api / one-api | sub2api |
|---|---|---|
| 往里填什么 | 上游的 API Key | 上游的账号(账号密码、OAuth 登录),部分厂商也收 Key |
| 额度从哪来 | Key 里已有的余额,花完再充 | OAuth 号按账号配额,上限和重置周期跟套餐走;Key 号按 Key 余额或账单扣 |
| 对外怎么算钱 | 按 Key 的用量记账、转发 | 对外分发调用权限,按 token 记用量和计费 |
| 主要成本 | 上游 API 的实际用量费用 | 订阅号:买号钱 × 补号次数 + 订阅续费;Key 号:上游用量费;都加机器 |
| 跑之前先要什么 | 一把能用的上游 Key | 一批能登录、配额还在的 OAuth 号,或有效的 API Key |
所以「自己搭一个中转站」和「自己搭一套 sub2api」是两件不同的事:前者的门槛是拿到 Key;后者接 OAuth 号的话门槛是持续拿到号,接 Key 账号的话门槛是拿到有效的 Key。前者怎么搭、要什么机器,见自己搭中转站。
号池里放的是什么号
先说最容易搞混的一层:普号不是订阅号。「普号」「订阅号」都是卖家的分档叫法,不是官方术语;「sub2api 格式」同样是号铺自己起的标签,官方没有这个说法。号铺标题里写「sub2api 格式」的,目前基本是 Grok 普号——能登录、能导进去跑,但没开会员,能用的额度就是厂商给免费账号的那一档。那句话只说明这份凭据能导进 sub2api,不代表带会员、也不代表承诺可用额度。想让号池扛住真实调用量,得先看清买的是哪一档。
再往下是项目支持的两种接入方式。这两种和卖家写的交付格式不是一回事,下面分开讲:
- OAuth 账号:走官方网页或客户端的登录授权流程,拿账密现场登、或者直接导现成的登录令牌,都算这条路。Claude、ChatGPT(Codex)、Gemini、Grok 目前都归在这一类,导进去之后由它自己维护登录令牌。
- Key 账号:直接填一把官方 API Key,不用账号密码。支持按 Key 接入的厂商(xAI 这类)走这条,额度直接从 Key 上扣。同一家能走哪种,看项目当前支持的接入类型。
它对号还有一层要求:OAuth 账号得能正常登录、配额还在;Key 账号得 Key 有效、权限和额度可用。已经被限制、或者验证过不去的号,导进去也调不通,报错还会让人以为是配置错了。另外,能接进来不等于订阅里的每个功能都能通过 API 调——客户端里有的,网关这一层不一定给。
号从哪来:三条路,差别在能不能持续
| 来源 | 好在哪 | 卡在哪 |
|---|---|---|
| 自己已经有的订阅号 | 不用另买,凭据在自己手上 | 订阅照续、额度也被占着;能扛多少调用量看套餐本身 |
| 从号铺买普号 | 按需买,单价低,随时补 | 存活期没保证,要一直补;号的历史你查不到 |
| 从号铺买成品订阅号 | 拿来就是开了会员的档位 | 单价跟会员档位走,补号价另算,要一直补 |
| 把 CPA 格式的号转过来 | 手里已经有现成的凭据 | 转过去不一定都能跑通,失败要自己排 |
几条路可以混着用:自己的号打底,掉了用买的号补。手里已经有 CPA 凭据的话可以再转一道,但转格式只换凭据结构,不会凭空多出账号或额度。
交付格式:账密、rt、sso、CPA 分别是什么
| 写法 | 实际给的是什么 | 导入时要注意 |
|---|---|---|
| 账号 + 密码 | 登录用的账号密码,有的连 2FA 密钥一起给 | 要拿它走一次授权才能进号池,只给账密不等于能直接导入 |
| 账号 + 密码 + rt(refresh token) | 额外带一个刷新令牌 | 令牌有效、接入方式对得上,才能拿它换访问令牌;放久了会失效 |
| sso(single sign-on) | 单点登录产生的会话或授权材料,结构各家不同 | 多半会过期,能不能直接导看项目支持哪种接入 |
| CPA 格式 | CLIProxyAPI 的账号凭据 JSON,一个号一份 | 结构和 sub2api 的不同,一般要转一道 |
CPA 这个词在这行里指的不是会计,是 CLIProxyAPI——另一个开源项目,它把 Antigravity、Codex、Claude Code、Grok Build 这类客户端包成标准接口,每个账号对应一份 auth JSON。市面上已经有现成的转换工具(CPA 转 sub2api 的、反向的、浏览器插件形式的都有),这也是为什么号铺的标题里会同时写「可转换 CPA 格式」。不过格式能转,不等于这个号在两边都能跑通,转完还得自己验。术语本身收在黑话词典里。
这几样材料里都可能挂着能进账号的凭据或授权信息,落到别人手里就可能被拿去登录、花额度。来路不明的转换站和插件别把号往里丢。
封号与条款风险:三层,别混在一起看
第一层:账号和凭据可能失效
号掉了程序不会坏,坏的是你答应给用户的可用额度。号池里同时被大量调用、额度在短时间内被吃掉,异常的多地登录、频繁切换,都可能触发上游风控。存活期没有统一的数——号从哪来、授权状态怎么样、用的时候符不符合上游规则,都影响它能撑多久。所以号池要按「随时会掉」来设计,不是按「号都稳」来设计。
第二层:平台条款
以 Anthropic 的条款为例(各家不同,不能直接套):消费者条款禁止把账号登录凭据分享给他人、禁止让账号对他人可用;商业条款禁止未经明确批准的转售。具体条款怎么写的,见中转站为什么便宜的最后一节。
第三层:项目自己怎么说
sub2api 的 README 自己就写明了:使用它可能违反上游服务条款,仅供技术学习与研究,不提供商业授权。仓库本身的许可证是 LGPL-3.0,那一条允许商用——这两句说的是两件事,别拿许可证当上游授权。
号要花多少钱
普号和订阅号不是一档价,订阅号的价格跟会员档位走。单价都不能直接当成本。自己续费的订阅号是「补号钱 × 补号次数 + 没掉的号照付的续费」;号铺买的成品号一般是按补进来的数量算钱,续费以卖家口径为准。两种都还要再加一台跑网关的机器。要是走 Key 账号接入,那部分的钱不是买号,是往 Key 里充的上游用量。
今天的实际报价看两页:Grok 普号报价(标题写「sub2api 格式」的目前基本是这一档)、Claude 普号报价。买号该看哪几项、什么写法要躲,见卡网渠道有哪几种。
什么情况适合用它
适合:手里本来就有一批订阅号,想让它们共用一套分发和记账;想把几份订阅的用量统一记到一张账上;想搞明白这类网关的架构。
不适合:只是自己要用 Claude 或 GPT 的 API。这类需求不用养号池,也不用操心补号——走官方 API,或者在中转站推荐里挑一家;第三方中转同样不用你维护号池,但上游会不会断、数据怎么走,买之前先看清楚。两条路怎么权衡,见中转站怎么选。
相关阅读
- 自己搭中转站:new-api / one-api 要什么机器、每月多少。
- 中转站为什么便宜:订阅拆卖这条线赚的是什么差价。
- 卡网渠道有哪几种:账密、卡密、CDK 的交付与风险。
- Claude 封号怎么办:号已经掉了,申诉和退款找谁。
- 黑话词典:sub2api、CPA、日抛这些词在报价里长什么样。
常见问题
sub2api 和 new-api 有什么区别
new-api 主要往里填 API Key,转发已有余额;sub2api 主要往里填账号,把账号的配额分发出去、按 token 记账收费,也支持部分厂商直接填 API Key。前者门槛是拿到 Key,后者是持续拿到号。
sub2api 支持哪些厂商
Claude、ChatGPT(Codex)、Gemini、Grok 都是走 OAuth 接入账号;支持按 Key 计的厂商(xAI 这类)还能只填 API Key。
CPA 格式的号能直接导进去吗
一般导不进去。CPA 是 CLIProxyAPI 的账号凭据 JSON,结构和 sub2api 的不同,通常要转一道;市面上有现成的转换工具,但转完不一定每个号都能跑通,失败的自己排。
买了号发现调不通,是号的问题还是配置的问题
先看具体报什么错。登不上可能出在号本身,也可能是网络、地区或验证;登得上,还要看模型权限、剩余配额、令牌状态和网关配置。别只凭能不能登录就判责任。
号池里的号多久掉一次
没有统一的数。号从哪来、授权状态怎么样、用的时候符不符合上游规则,都影响能撑多久;被大量调用、额度被短时间内吃掉,会掉得更快。号池按「随时会掉」来算补号成本就对了。
用它对外收费有什么风险
至少三层:账号和凭据随时可能失效,掉的是你答应给用户的额度;上游平台的条款可能限制共享凭据或转售,以 Anthropic 为例,消费者条款禁止共享账号、商业条款禁止未经批准的转售,各家不同不能照套;项目自己的 README 也声明仅供技术学习与研究、不提供商业授权。
只是想用 API,需要搭这个吗
不需要。自己用 Claude 或 GPT 的 API,走官方 API,或在中转站推荐里挑一家;中转不用你维护号池,但上游会不会断、数据怎么走,买之前先看清楚。