AI API 网关平台，将 Claude/OpenAI/Gemini/Grok 等订阅账号的配额统一转为标准 API Key 对外分发，支持多账号拼车分摊成本，33.5k stars。
定位
Sub2API（Subscription to API）解决的问题：AI 订阅（Claude Pro/Max、ChatGPT Plus、Gemini、Grok 等）本身不提供 API 访问，只能在官方客户端内使用。Sub2API 作为中间网关，接管订阅账号的鉴权（OAuth/API Key），把配额转换成用户可分发的 API Key，实现多人共享一组订阅账号（拼车）、按 token 精确计费、负载均衡调度。
Go + Vue3 全栈实现，单二进制内嵌前端，支持脚本一键安装 / Docker Compose / Apple Container（macOS）/ 源码构建四种部署方式。
⚠️ README 明确声明：使用本项目可能违反 Anthropic 等上游服务商的服务条款，风险自担；项目仅供技术学习研究，作者不对账号封禁等后果负责，也未授权任何商业化运营。
核心特性
- 多账号管理：同时管理多个上游账号（OAuth 订阅账号 + API Key 账号）
- API Key 分发：为终端用户生成/管理独立 API Key
- 精确计费：token 级用量统计与成本计算
- 智能调度：账号选择 + sticky session（保持会话路由到同一账号）
- 并发/限流控制：按用户、按账号分别设置并发上限和速率限制
- 内置支付系统：EasyPay/支付宝/微信支付/Stripe，用户自助充值，无需额外部署支付服务
- 管理后台：Web Dashboard，可通过 iframe 嵌入外部工单系统等
- 多 Provider 支持：Claude、OpenAI、Gemini，以及 Grok（xAI OAuth + API Key 双模式）、Antigravity（Claude/Gemini 专用端点）
技术栈
| 组件 | 技术 |
|---|---|
| 后端 | Go 1.25.7, Gin, Ent (ORM) |
| 前端 | Vue 3.4+, Vite 5+, TailwindCSS |
| 数据库 | PostgreSQL 15+ |
| 缓存/队列 | Redis 7+ |
| 部署 | 单二进制内嵌前端（-tags embed）/ Docker Compose / systemd |
仓库内还附带一个 Claude Code Skill（skills/sub2api-admin），用于通过命令行直接调用 Sub2API 管理 API，但这只是运维辅助功能，项目主体是网关服务本身，因此归类为 opensources/ 而非 skills/。
适用场景
- 团队/好友之间合租 Claude Max、ChatGPT Plus 等订阅账号，统一走 API 访问并按量计费
- 需要把订阅制 AI 产品接入 Claude Code / Codex / Gemini CLI 等原生工具链（保留 tool use、长上下文等原生能力）
- 自建小型 AI API 中转/分发服务，替代人工分享账号密码的方式
局限性
- 存在违反上游服务商条款的合规风险，官方明确不提供商业授权
- 依赖 PostgreSQL + Redis，非纯轻量单文件部署
- Sora 相关功能因上游集成问题暂不可用
- 生产环境需额外配置安全项（URL allowlist、trusted proxies、CSP 等），默认配置偏开发友好，直接上生产前需收紧
生态系统
- 关联项目 sub2api-mobile：跨平台移动端管理控制台（Expo + React Native）
- 原独立支付项目 Sub2ApiPay 已并入主项目内置支付系统
- 与 CRS（Claude Relay Service）同属”订阅转 API 中转”类工具，Nginx 反代场景下的注意事项（如
underscores_in_headers on）相通