甄选 API

sub2api 是什么:号池要什么号、怎么买、封号风险

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-apisub2api
往里填什么上游的 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,或者在中转站推荐里挑一家;第三方中转同样不用你维护号池,但上游会不会断、数据怎么走,买之前先看清楚。两条路怎么权衡,见中转站怎么选。

相关阅读

常见问题

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,或在中转站推荐里挑一家;中转不用你维护号池,但上游会不会断、数据怎么走,买之前先看清楚。