一、Sub2API 是什么？

简单来说，Sub2API 是一个完全开源的 AI 订阅 API 网关中转分发管理平台。它的核心作用，就是把市面上各类 AI 订阅服务，统一转换成标准的 API 接口，同时还自带多账号管理、配额分发和精确计费这些全套能力。

一句话概括：把你的 AI 订阅账号（比如 Claude Pro、ChatGPT Plus、Gemini 等）变成标准 API 接口，然后统一管理、智能调度、按量计费。

核心定位

核心功能

• 多账号管理：支持 OAuth 和 API Key 两种上游账号类型，可以同时接入多个订阅账号。
• API Key 分发：为每个用户或团队生成独立的 API Key。
• 智能调度：多账号自动负载均衡，加上粘性会话机制（同一对话固定路由到同一账号）。
• 精确计费：Token 级别用量追踪，按量扣费。
• 并发控制：用户级和账号级并发限制，防止资源被抢占。
• 速率限制：可配置的请求频率和 Token 速率限制。
• 内置支付：支持易支付、支付宝、微信、Stripe，用户能自助充值。
• Web 管理后台：完整的监控、用户管理、账号管理界面。

支持的 AI 模型

二、技术架构

项目结构

sub2api/
├── backend/          # Go 后端（API网关核心 + 业务逻辑）
│   ├── internal/
│   │   ├── gateway/  # 请求转发、调度、计费
│   │   ├── service/  # 用户/账号/计费服务
│   │   └── handler/  # HTTP 处理器
├── frontend/         # Vue 3 管理后台
└── deploy/           # Docker Compose + 安装脚本

三、快速部署

方式一：Docker Compose（推荐）

# 创建目录并一键部署
mkdir -p sub2api-deploy && cd sub2api-deploy
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash
docker compose up -d

部署完成后访问 https://你的IP:8080，用向导完成数据库和管理员配置。

方式二：一键脚本

# 前提：已安装 PostgreSQL 15+ 和 Redis 7+
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
sudo systemctl start sub2api

关键环境变量

POSTGRES_PASSWORD=your_secure_password
JWT_SECRET=your_jwt_secret  # openssl rand -hex 32
TOTP_ENCRYPTION_KEY=your_key  # openssl rand -hex 32
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=your_password
SERVER_PORT=8080

四、Sub2API 与魔芋AI的关系

很多人会问：Sub2API 和魔芋AI有什么区别？该怎么选？

本质区别

简单说：Sub2API 是给“想当中转站”的人用的工具，魔芋AI则是已经建好的中转站。

五、把魔芋接入 Sub2API 统一管理

如果你已经在用 Sub2API 管理自己的订阅账号，同时也在用魔芋的 API，那么可以通过 Sub2API 的 API Key 上游接入功能，把魔芋也纳入统一管理。

第一步：在魔芋AI获取 API Key

点击链接前往 api 平台：https://www.moyu.info/register?aff=g2d7

使用手机号码进行账号注册。

注册成功后登录进入【令牌管理】。

配置完成后，你可以使用新配置的令牌，或者平台初始生成的令牌。

第二步：在 Sub2API 添加上游账号

1. 登录 Sub2API 管理后台。
2. 进入 账号管理 → 添加账号。
3. 账号类型选择 API Key 模式。
4. 填写配置：
   • Base URL：魔芋的 API 地址（如 https://api.moyu.info）。
   • API Key：你在魔芋创建的令牌。
   • 支持的模型：根据需要勾选（GPT-4o、Claude 等）。

第三步：配置调度优先级

Sub2API 支持智能调度，你可以设置：

• 优先级：让魔芋作为备用通道，订阅账号优先使用。
• 权重：按比例分配请求流量。
• 分组：不同模型或用途使用不同的账号组。

典型使用场景

接入效果

接入后，你的用户或团队只需要一个 Sub2API 的 API Key，背后自动在订阅账号和魔芋之间智能调度，对调用方完全透明。

用户请求 → Sub2API 统一入口
├→ 订阅账号A（Claude Pro） ← 优先
├→ 订阅账号B（Claude Pro） ← 负载均衡
└→ 魔芋 API ← 备用/溢出

六、进阶配置

Nginx 反向袋里（必须注意）

如果你用 Nginx 反代 Sub2API，务必在 http 块中添加：

underscores_in_headers on;

否则 Codex CLI 的粘性会话会失效——Nginx 默认丢弃含下划线的请求头。

简易模式（个人使用）

不需要计费功能？设置环境变量：

RUN_MODE=simple
SIMPLE_MODE_CONFIRM=true  # 生产环境必须

这样就隐藏了 SaaS 功能，跳过了计费流程，适合个人或内部团队使用。

移动端管理

社区项目 sub2api-mobile 提供了 iOS/Android 跨平台管理 App，支持多后端切换。

七、竞品对比

Sub2API 的独特优势在于：专门针对“订阅转 API”这一场景设计，调度策略更精细（粘性会话、混合调度），内置支付系统，提供了开箱即用的 SaaS 能力。