sub2api 是什么?

Sub2API 是一个开源的「AI API 网关」平台(Go + Vue),其用途是把 AI 产品订阅(如 Claude、OpenAI、Gemini、Antigravity 等)的额度集中起来,通过平台统一签发 API Key 对外分发,并处理鉴权、计费、负载均衡和请求转发。需要首先明确风险:它的典型用法——把面向个人的订阅账号转为 API 对外提供、以及多人「拼车共享」同一订阅——通常与上游 AI 服务商的服务条款相冲突(账号共享、转售、以非官方方式访问订阅等条款常被禁止)。本页仅作客观编目,说明该项目的存在与性质,不提供搭建或绕过相关的操作指引;是否使用应由读者在充分评估法律、版权、服务条款、账号安全与隐私风险后自行判断。

⭐ 23,824 Stars 🍴 4,564 Forks Go 作者: Wei-Shaw
来源: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 分发与计费

为用户生成和管理 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+)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) PostgreSQL 15+(主存储)PostgreSQL 15+… Redis 7+(缓存/限流)Redis 7+(缓存/… Docker(部署) 多账号管理 API Key 分发与计费 调度与并发/限流控制 管理后台 sub2api 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Go(后端)、Vue/TypeScript(前端)框架Go Web 服务 + ent ORM + wire 依赖注入;Vue 3 管理后台
PostgreSQL 15+(主存储)Redis 7+(缓存/限流)Docker(部署)
Docker / goreleaser 发布,GitHub Actions(后端 CI、安全扫描、release)
来源:README.md(技术徽章);git tree(backend/ent/、.goreleaser.yaml、Dockerfile、.github/workflows/security-scan.yml)

快速上手

出于合规考虑,本页不提供该项目的部署或配置步骤。仅作技术编目:它是可自托管的 Go + Vue 平台,依赖 PostgreSQL 与 Redis,官方提供在线 Demo 与文档。需要特别提醒的是——将个人 AI 订阅账号集中托管、转为 API 对外提供,或多人共享同一订阅(拼车),通常违反 Claude/OpenAI/Gemini 等上游服务商的服务条款,可能导致账号封禁、订阅终止乃至法律/合同责任;围绕此类网关的「住宅代理降低风控关联」「零封号风险」等说法本身即指向规避上游反滥用机制的行为。任何部署前应先确认是否获得上游服务商授权、是否符合其条款。
来源:README.md(Demo、Overview);Sponsors 段落中关于风控规避与折扣转售的描述(用于风险说明)

使用场景

从项目自述看,其面向的是「订阅额度的分发与管理」——即把若干 AI 订阅集中后按 API Key 分发给多人使用并计费。需要客观指出:这些用法绝大多数落在上游服务条款的禁区(账号共享、订阅转售、非官方 API 化访问)。真正合规的等价需求,应通过各 AI 服务商官方提供的企业/团队方案、官方 API 和官方计费来满足,而不是通过此类中转网关。本页不推荐将其用于规避上游条款的任何场景。

来源:README.md(Overview、Features);综合合规判断

优势与局限

优势

  • 工程上是一个功能较完整的 API 网关:多账号、Key 分发、计费、限流、管理后台、内置支付
  • 技术栈成熟(Go + ent + PostgreSQL + Redis + Vue),有 CI 与安全扫描、Docker 发布

局限

  • 核心用途(订阅转 API、拼车共享、转售额度)通常违反 Claude/OpenAI/Gemini 等上游服务条款
  • 围绕其生态存在「住宅代理规避风控关联」「零封号风险」等说法,指向规避上游反滥用机制
  • 使用者面临账号封禁、订阅终止、数据/支付安全与潜在法律/合同风险
  • 存在大量第三方商业部署并借用其名义,README 自身也提醒需自行甄别真伪
来源:README.md(顶部域名声明、Features、Sponsors 段落);综合 ToS/合规判断

最新版本

本页不追踪该项目的具体发行版变更内容。仓库使用 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 生态描述、以及上游服务条款与合规判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 12:03. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件