Sub2API 是一个开源的「AI API 网关」平台(Go + Vue),其用途是把 AI 产品订阅(如 Claude、OpenAI、Gemini、Antigravity 等)的额度集中起来,通过平台统一签发 API Key 对外分发,并处理鉴权、计费、负载均衡和请求转发。需要首先明确风险:它的典型用法——把面向个人的订阅账号转为 API 对外提供、以及多人「拼车共享」同一订阅——通常与上游 AI 服务商的服务条款相冲突(账号共享、转售、以非官方方式访问订阅等条款常被禁止)。本页仅作客观编目,说明该项目的存在与性质,不提供搭建或绕过相关的操作指引;是否使用应由读者在充分评估法律、版权、服务条款、账号安全与隐私风险后自行判断。
来源:README.md(Overview、Features);GitHub 仓库描述与 topics(cc2api、antigravity2api、claude-code 等) 查看 GitHub 仓库 →随着 Claude Code、Codex、Gemini CLI 等订阅制 AI 编码工具普及,围绕「把订阅额度转成 API、按量分摊、低价中转」形成了一条灰色产业链,Sub2API 是其中被广泛用作底座的开源网关之一,README 中列出了大量基于它搭建的商业中转服务赞助商。这类热度很大程度来自成本套利诉求,但也伴随明确的合规风险。客观记录:截至数据采集仓库约 23,039 stars。需要强调的是,高 star 不代表其用途合规——围绕它的生态包含订阅转售、按官方价极低折扣售卖、以及用住宅代理「降低风控关联」等做法,这些都可能违反上游服务商条款并带来账号封禁与法律风险。
来源:README.md(Sponsors 段落中的中转服务描述:如「7% of original price」「reduces probability of association-based risk control」等);GitHub 仓库元数据(stars=23039)支持管理多种上游账号类型(OAuth、API Key),把多个订阅/账号纳入统一池。这里需提示:把个人订阅账号集中托管并对外提供,常与上游服务条款相冲突。
来源:README.md(Features → Multi-Account Management)为用户生成和管理 API Key,并做 token 级用量追踪与成本计算;内置支付(EasyPay/支付宝/微信/Stripe)支持用户自助充值。
来源:README.md(Features → API Key Distribution、Precise Billing、Built-in Payment System)提供智能选号(带粘性会话)、按用户/按账号的并发限制和可配置的请求与 token 速率限制。
来源:README.md(Features → Smart Scheduling、Concurrency Control、Rate Limiting)提供 Web 管理界面用于监控与管理,并可通过 iframe 嵌入外部系统(如工单系统)扩展后台。
来源:README.md(Features → Admin Dashboard、External System Integration)从公开代码看,Sub2API 是一个标准的 Go 后端 + Vue 前端的 Web 平台。后端位于 backend/,入口 cmd/server,使用 ent 作为 ORM(可见 account、accountgroup、announcement 等实体的生成代码),依赖 PostgreSQL 做主存储、Redis 做缓存/限流,依赖注入用 wire;提供管理后台(Vue 3)。功能层围绕「上游账号管理 → API Key 签发 → 调度转发 → 计费」组织。本页不展开其与各上游服务对接、调度选号或转发的具体实现细节,因为这类细节涉及对上游服务的非官方访问方式;读者若关注,应以是否符合上游服务条款为前提自行查阅源码。
来源:git tree(backend/cmd/server、backend/ent/、wire_gen.go);README.md 徽章(Go 1.25.7、Vue 3.4+、PostgreSQL 15+、Redis 7+)中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
PostgreSQL 15+(主存储)Redis 7+(缓存/限流)Docker(部署)从项目自述看,其面向的是「订阅额度的分发与管理」——即把若干 AI 订阅集中后按 API Key 分发给多人使用并计费。需要客观指出:这些用法绝大多数落在上游服务条款的禁区(账号共享、订阅转售、非官方 API 化访问)。真正合规的等价需求,应通过各 AI 服务商官方提供的企业/团队方案、官方 API 和官方计费来满足,而不是通过此类中转网关。本页不推荐将其用于规避上游条款的任何场景。
来源:README.md(Overview、Features);综合合规判断本页不追踪该项目的具体发行版变更内容。仓库使用 goreleaser 发布、带后端 CI 与安全扫描工作流,版本信息记录在 backend/cmd/server/VERSION。读者如需了解版本细节,应在确认用途合规的前提下自行查阅仓库 releases。
来源:git tree(.goreleaser.yaml、.github/workflows/release.yml、backend/cmd/server/VERSION)Sub2API 在工程上是一个完成度较高的 AI API 网关,但它的主要用途——把个人 AI 订阅集中转为 API 对外分发、多人拼车共享、低价转售额度——通常与 Claude/OpenAI/Gemini 等上游服务商的服务条款相冲突,并伴随账号封禁、规避风控、支付与数据安全以及法律/合同等多重风险。本页只对其性质做客观编目,不提供搭建或规避指引。对有「降低 AI 使用成本」「团队统一接入」等真实需求的读者,建议走官方企业/团队方案与官方 API、官方计费,而非此类中转网关。
来源:综合 README.md 的自述与 Sponsors 生态描述、以及上游服务条款与合规判断