Sub2API：一站式开源 AI API 网关平台

开篇：为什么你需要 Sub2API？

凌晨两点，你刚写完一段 Claude Code 的自动化脚本，兴冲冲跑起来——然后被告知"账号已达配额上限"。第二天你换了新账号，第三天又换。一个人的 API 额度不够用，但多买几个账号又太贵，账号管理成了甜蜜的烦恼。

Sub2API 就是来解决这个问题的：它把多个 AI 平台的订阅账号（比如 Claude Code、OpenAI Codex、Gemini）汇聚成一个统一的 API 网关，通过给团队成员分发 API Key，实现"拼车共享"——每个人按量付费，额度灵活分配，管理员一目了然。

图1：Sub2API 多平台聚合架构示意

---

背景：AI API 消费的"拼车经济"

2024年以来，Claude Code、OpenAI Codex、Google Gemini 等 AI 编程工具迅速普及。但这些平台的 API 采用订阅制或个人账号配额制——

• Claude Code 按席位数收费，个人开发者额度有限
• OpenAI Codex 有 RPM/TPM 限制，多人协作时容易撞墙
• Gemini 额度虽大，但不同地区/账号策略不一

对于小型团队或开发者社区来说，要么每人单独买号成本高，要么共享一个账号没有隔离——轻则互相挤占额度，重则一个账号被封全员遭殃。

Sub2API 的出现，顺应了这股"AI 订阅共享经济"的潮流。作者 Wei-Shaw 最早在 2024 年初启动这个项目，在 GitHub 上获得了超过 2.3 万颗星，迅速成为 AI API 中转领域最热门的开源项目之一。

---

类比：Sub2API 是什么？

如果说 AI API 服务商（如 OpenAI、Anthropic）是"出租车公司"，提供原始运力，那么 Sub2API 就是调度中心 + 计价器：

• 调度中心：统一接收所有乘客（API 调用请求），自动分配到最合适的车辆（上游账号）
• 计价器：精确记录每个乘客消耗了多少 token，按量计费
• 车队管理：支持多辆"车"（多个账号），智能选择哪辆去接哪单

普通用户看到的只是一个 API 地址（类似 https://api.yoursub2api.com/v1/chat/completions），背后 Sub2API 帮你搞定负载均衡、故障切换、额度管控。

---

核心功能：不止于"转接"

多账号聚合与智能调度

Sub2API 支持同时接入多个上游 AI 账号（Claude、OpenAI、Gemini、Antigravity 等），系统会根据配置自动选择最优账号响应请求。支持粘性会话——同一个对话的所有请求都路由到同一个上游账号，保证上下文连贯。

API Key 分发与精确计费

管理员可以为团队成员或客户生成独立 API Key，每个 Key 的用量独立统计（Token 级别），支持 RPM（每分钟请求数）和 TPM（每分钟 Token 数）双重限速。计费逻辑完全透明。

内置支付系统

这是 Sub2API 区别于其他简单代理的亮点——它内置了 EasyPay、支付宝、微信支付、Stripe 等支付渠道的集成，用户可以自助充值。运营者不需要额外部署支付服务，就能实现"付费 API 服务"的商业闭环。

Web 管理后台

提供完整的 Vue 3 管理界面：账号管理、渠道监控、用量统计、套餐订阅、用户管理、公告系统、 affiliates（推广返利）……基本涵盖了 API 中转服务的所有运营需求。

安全与合规

• TOTP 两步验证（管理员账号可选开启）
• API Key 敏感数据加密存储
• TLS 指纹伪装（绕过某些 AI 服务对非官方客户端的封锁）
• 完整操作审计日志

---

技术架构：Go + Vue 3 的强强组合

Sub2API 采用前后端分离架构，后端用 Go（gin 框架 + ent ORM + PostgreSQL + Redis），前端用 Vue 3 + TypeScript + Vite + Tailwind CSS。

后端（Go）

后端使用 Go 语言，性能和并发处理能力出色，部署产物是单一二进制文件。核心依赖包括：

• gin：HTTP 路由框架，处理 API 请求
• ent：代码生成式 ORM，直接从 schema 定义生成数据库操作代码
• go-zero：微服务工具集，提供限流、熔断等能力
• redis/go-redis：缓存和会话存储
• lib/pq + modernc.org/sqlite：PostgreSQL 为主，SQLite 用于轻量场景

代码规模相当大——仅 backend/internal/handler/ 下就有数十个 handler 文件，覆盖了 admin、auth、api、payment、channel monitor 等完整业务域。

前端（Vue 3）

Vue 3 + TypeScript 全家桶：Pinia 状态管理、Vue Router、Vue I18n 多语言支持（内置中文、英文、日文文档）。UI 组件库未引入第三方组件库，采用了 Tailwind CSS 手工样式，保持了代码可控性。

部署架构

用户请求 → Sub2API (Go) → PostgreSQL(元数据) + Redis(缓存)
                    ↓
         上游 AI 服务（Claude/OpenAI/Gemini）

容器化方面，项目提供了：

1. 多阶段 Dockerfile：Node 构建前端 → Go 构建后端 → 最终最小镜像
2. 完整 docker-compose.yml：一键启动 Sub2API + PostgreSQL + Redis
3. Zeabur 一键部署模板：适合不想自建服务器的团队

---

上手体验：部署门槛高不高？

优点：

• Docker Compose 一键启动，AUTO_SETUP=true 自动初始化，理论上 30 分钟可跑起来
• 提供在线 Demo（demo.sub2api.org），可以先体验再决定是否部署
• 文档完整（README、DEV_GUIDE、DOCKER.md、PAYMENT_CN.md）

需要注意：

• 需要准备 PostgreSQL 和 Redis，docker-compose 已内置但生产环境建议独立部署
• 配置项较多（支付渠道、TLS 指纹、渠道监控规则等），初次部署有一定学习成本
• Web UI 依赖前后端通信，开发模式需要配置 Vite 代理

---

争议与局限

1. 灰色地带：AI API 中转服务在某些地区存在合规争议，Sub2API 官方也明确声明了免责条款，用户需自行评估法律风险
2. 维护成本：项目更新频繁（2026年4月刚发布 v0.1.110），升级需要谨慎测试
3. 规模化挑战：单节点部署适合中小团队，超大规模需要额外做高可用改造

---

行业意义：开源的力量

Sub2API 获得了超过 2.3 万 GitHub Stars，生态内涌现了大量赞助商和商业中转服务（PinCC、PackyCode、CTok 等）。它证明了一个开源项目可以通过"工具+商业服务"的模式形成健康生态——开发者免费用开源版，商业公司提供托管服务并反哺开源。

---

总结

Sub2API 是目前最成熟的开源 AI API 网关方案，核心价值在于把多个 AI 订阅账号变成一个可控、可计量、可运营的统一服务。适合团队共享 AI 额度、开发者自建 API 中转服务、以及有一定运营能力的个人或小团队搭建付费 API 平台。