Sub2API：订阅转API网关平台，魔芋AI接入指南

一、Sub2API 是什么？

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

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

GitHub项目链接 ：Wei-Shaw/sub2api（⭐ 18.8+，Fork 3.4k+）

核心定位

	说明
类型	AI API 网关平台（Subscription to API Gateway）
解决的问题	团队/个人购买了多个 AI 订阅账号，想转成 API 供多人共享使用
适用场景	团队拼车、API 中转站、企业内部 AI 资源统一管理
开源协议	LGPL v3.0

核心功能

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

支持的 AI 模型

厂商	状态	说明
Claude（Anthropic）	✅ 已支持	Claude 全系列，含 Claude Code
GPT（OpenAI）	✅ 已支持	GPT-4o、o1、o3、Codex 等
Gemini（Google）	✅ 已支持	Gemini 全系列
Antigravity	✅ 已支持	专用端点，支持混合调度
更多	🔜 即将推出	---

二、技术架构

组件	技术选型
后端	Go 1.25.7 + Gin + Ent ORM
前端	Vue 3.4 + Vite 5 + TailwindCSS
数据库	PostgreSQL 15+
缓存/队列	Redis 7+
部署	Docker Compose / 一键脚本 / 源码编译

项目结构

复制代码

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

部署完成后访问 http://你的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
定位	自建网关，管理自己的订阅账号	API 中转站，直接提供现成 API
数据源	你自己的订阅账号（Claude Pro 等）	魔芋统一采购和运营
运维要求	需要自己部署服务器、管理账号	零部署，注册即用
成本模型	订阅费 + 服务器成本，多人分摊	按量付费，用多少付多少
灵活性	高，完全可控	中，依赖魔芋支持
适合谁	有技术能力的团队、需要自建的商家	想快速接入的用户、中小企业

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

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

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

接入步骤

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

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

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

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

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

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

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

第三步：配置调度优先级

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

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

典型使用场景

场景	配置方案
订阅账号不够用	魔芋作为溢出通道，订阅账号并发满了自动切到魔芋
模型互补	订阅只有 Claude，魔芋补充 GPT 和 Gemini
降低成本	高频简单请求走魔芋按量付费，复杂请求走订阅
高可用	一个订阅挂了自动切换到魔芋，不中断服务

接入效果

接入后，你的用户/团队只需要一个 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，支持多后端切换。

七、竞品对比

项目	Star	特点	适合谁
Sub2API	16.2k	订阅转API，专注调度和计费	有订阅账号想共享/变现的团队
One API	50k+	通用 API 聚合管理	需要 Key 聚合、渠道管理的场景
New API	20k+	One API 增强版，模型更多	需要 One API + 更多模型的用户

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