project
Sub2API - 开源 AI API 中转网关平台,支持多账户管理
Sub2API 是开源 AI API 中转网关平台,支持将 Claude、OpenAI、Gemini、Antigravity 等主流 AI 服务的订阅统一接入管理。平台提供多账号管理、API Key 分发、...
Sub2API是什么
Sub2API 是开源 AI API 中转网关平台,支持将 Claude、OpenAI、Gemini、Antigravity 等主流 AI 服务的订阅统一接入管理。平台提供多账号管理、API Key 分发、Token 级精准计费、智能调度和并发控制等功能,实现”拼车共享”模式高效分摊订阅成本。用户可通过平台生成的 API Key 访问上游 AI 服务,原生客户端工具可无缝使用。Sub2API 采用 Go + Vue 技术栈,适合个人开发者或团队搭建私有的 AI API 分发系统。
Sub2API的主要功能
-
多账号管理:支持 OAuth 和 API Key 等多种认证方式,统一接入 Claude、OpenAI、Gemini、Antigravity 等主流 AI 服务账号。
-
API Key 分发:为下游用户生成和管理独立的 API Key,支持自定义前缀,实现安全的访问控制。
-
精准计费:提供 Token 级别的用量追踪和实时成本计算,确保费用分摊透明准确。
-
智能调度:通过智能算法选择最优账号,支持粘性会话,保证同一对话始终路由到同一上游账号。
-
并发控制:支持按用户和按账号设置并发限制,防止单一用户或账号过载影响整体服务稳定性。
-
速率限制:平台可灵活配置请求频率和 Token 消耗速率。
-
管理后台:提供功能完善的 Web 管理界面,支持实时监控、数据统计、账号管理,可嵌入支付等外部系统。
Sub2API的关键信息和使用要求
-
官方域名:
sub2api.org和pincc.ai(其他域名均为第三方部署) -
技术栈:Go + Vue3 + PostgreSQL + Redis
-
开源协议:MIT License
-
官方托管服务:PinCC(无需自建,即开即用)
-
操作系统:Linux(amd64 或 arm64)
-
Go 版本:1.21+(源码编译)
-
Node.js:18+(前端开发)
-
PostgreSQL:15+
-
Redis:7+
Sub2API的核心优势
- 成本分摊:支持多人共享 AI 订阅账号,通过 Token 级精准计费实现费用公平分摊,大幅降低个人使用成本。
- 统一接入:单一平台整合 Claude、OpenAI、Gemini、Antigravity 等主流 AI 服务,无需分别管理多个官方账号。
- 原生兼容:下游用户可直接使用官方客户端和工具(如 Claude Code、Codex CLI),无需修改代码或学习新接口。
- 智能调度:内置负载均衡和粘性会话机制,自动选择最优账号并保证对话连续性,提升使用体验和稳定性。
- 灵活部署:提供脚本一键安装、Docker Compose、源码编译三种部署方式,满足不同技术水平和场景需求。
- 精细管控:支持并发限制、速率限制、用量监控等多维度管控,有效防止账号过载和触发平台风控。
如何使用Sub2API
- 方式一:官方托管服务 PinCC(推荐新手)
- 访问注册:打开
pincc.ai官网完成账号注册。 - 充值额度:选择套餐充值或按量付费,获取使用额度。
- 生成密钥:在控制台创建 API Key,用于客户端认证。
- 配置使用:将 Base URL 和 API Key 填入官方客户端即可开始使用。
- 访问注册:打开
- 方式二:自建部署(推荐技术用户)
- 准备阶段
- 环境准备:准备 Linux 服务器并安装 PostgreSQL 15+ 和 Redis 7+。
- 执行安装:运行官方一键脚本自动完成程序部署和系统服务配置。
- 初始化配置:访问服务器 8080 端口完成数据库连接和管理员账号创建。
- 配置阶段
- 添加上游:在管理后台添加 Claude、OpenAI 等 AI 服务账号并完成授权。
- 创建用户:为下游用户生成独立 API Key 并分配使用额度或计费规则。
- 客户端接入:用户将平台提供的 Base URL 和 API Key 配置到官方客户端工具中。
- 准备阶段
Sub2API的项目地址
- 项目官网:https://demo.sub2api.org/home
- GitHub仓库:https://github.com/Wei-Shaw/sub2api
Sub2API的同类竞品对比
| 对比维度 | Sub2API | One API | New API | AI Gateway |
|---|---|---|---|---|
| 开源协议 | MIT License | MIT License | MIT License | 部分开源/商业版 |
| 部署方式 | 脚本/Docker/源码 | Docker/源码 | Docker/二进制 | Docker/云服务 |
| 支持模型 | Claude/OpenAI/Gemini | OpenAI/Claude/文心/通义等 | OpenAI/Claude/Gemini等 | OpenAI/Anthropic/自建模型 |
| 核心定位 | 订阅配额分发与拼车共享 | 多模型统一接入与转发 | 高性价比 API 中转 | 企业级 API 管理与安全 |
| 计费精度 | Token 级精准计费 | Token 级计费 | 按次或 Token 计费 | Token 级计费 |
| 账号管理 | 多账号智能调度+粘性会话 | 多渠道负载均衡 | 多 Key 轮询 | 企业级账号池管理 |
| 用户系统 | 完整 SaaS 用户体系 | 简单用户管理 | 基础用户管理 | 企业级 RBAC 权限 |
| 特色功能 | 拼车成本分摊、简单模式 | 渠道重试、优先级控制 | 低价中转、高并发 | 审计日志、安全合规 |
Sub2API的应用场景
- AI 订阅拼车共享:多人共同分摊 Claude Pro、OpenAI Plus 等昂贵订阅费用,通过 Token 级精准计费实现公平的成本分摊,让个人开发者用较低成本使用顶级 AI 模型。
- 团队 AI 资源统一管理:企业或团队集中管理多个 AI 服务账号,统一生成和分配 API Key 给成员使用,避免直接共享账号密码导致的安全风险,同时实现精细化的权限和用量管控。
- 个人多账号聚合:个人用户将散落在不同平台的 AI 账号整合到单一入口,无需频繁切换多个官方客户端,在一个界面内统一调用 Claude、Gemini、OpenAI 等各类服务。
- AI 服务二次分发:技术爱好者或小型服务商可搭建私有 API 中转站,为下游用户或客户提供稳定的 AI 接口服务,支持自定义计费策略和额度管理,实现轻量级 SaaS 化运营。
- 开发测试环境隔离:为开发和测试环境提供独立的 AI 接口访问通道,与生产环境账号完全隔离,防止测试流量触发平台风控或耗尽正式账号的额度配额。