Sub2API

随着 AI 应用成本的攀升，如何高效管理昂贵的模型订阅（如 Claude Code $200/月、OpenAI Enterprise 等），并在团队内部公平分摊成本，成为许多开发者和企业的痛点。

Sub2API 是一个基于 Go 和 Vue 构建的高性能 AI API 网关平台，专为订阅配额的分发、管理与计费而设计。它允许你将上游的多个 AI 账号聚合为一个统一入口，通过生成独立的 API Key 分发给用户，自动完成鉴权、Token 级精确计费、智能负载均衡及并发控制。

核心功能：让每一分 Token 都清晰可控

1. 多账号聚合与智能调度

• 混合接入：同时支持 OAuth 登录态（如 Claude Desktop 会话）和传统 API Key 等多种上游认证方式。
• 智能路由：内置智能调度算法，支持粘性会话（确保同一用户的连续对话落在同一账号），自动轮询或根据负载动态选择最优上游账号。
• 故障转移：当某账号达到限额或报错时，自动切换至备用账号，保障服务高可用。

2. Token 级精确计费

• 实时追踪：对每个请求的 Input/Output Token 进行毫秒级统计。
• 成本核算：支持自定义不同模型的单价，自动计算每次调用的实际成本。
• 配额管理：可为每个用户/Key 设置每日/每月额度，超额自动熔断，杜绝账单爆炸。

3. 细粒度流控与并发限制

• 双层限流：支持用户级（防止单用户滥用）和账号级（防止上游封号）的并发限制。
• 速率限制：可配置 RPS（每秒请求数）和 TPM（每分钟 Token 数），灵活应对不同场景的流量洪峰。

4. 可视化管理后台

• 全景监控：实时展示总用量、各账号负载、用户消费排行等关键指标。
• 密钥管理：在线生成、吊销、重置 API Key，查看调用日志。
• 一键升级：内置在线更新检测与应用功能，支持回滚，运维无忧。

技术架构：高性能与现代化

Sub2API 采用主流且高效的技术栈，确保系统稳定易扩展：

⚡ 部署指南：两种推荐方式

Sub2API 提供极其便捷的部署方案，无论是裸机还是容器化环境，均可分钟级上线。

方式一：脚本安装（Linux 裸机推荐）

一键脚本自动完成二进制下载、服务配置及系统优化。

前置条件：Linux (amd64/arm64), PostgreSQL 15+, Redis 7+, Root 权限。

# 一键安装
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

# 启动并设置开机自启
sudo systemctl start sub2api
sudo systemctl enable sub2api

# 访问设置向导 (http://你的IP:8080)
# 完成数据库、Redis 及管理员账号配置

常用运维命令：

sudo systemctl status sub2api   # 查看状态
sudo journalctl -u sub2api -f   # 实时日志
sudo systemctl restart sub2api  # 重启
# 卸载
curl -sSL .../install.sh | sudo bash -s -- uninstall -y

方式二：Docker Compose（容器化推荐）

包含完整的 DB 和 Redis 依赖，隔离性好，易于迁移。

# 创建目录并进入
mkdir -p sub2api-deploy && cd sub2api-deploy

# 运行自动化部署脚本（自动生成 .env 和安全密钥）
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f sub2api

提示：脚本会自动生成 JWT_SECRET、POSTGRES_PASSWORD 等安全凭证并保存至 .env 文件，请务必妥善保管。

高级特性与兼容性说明

OpenAI Responses API 兼容

Sub2API 深度适配 OpenAI 最新的 Responses API 规范，特别处理了复杂的上下文依赖问题：

• Function Call 支持：自动处理 function_call_output 与 previous_response_id 的关联，避免 "No tool call found" 错误。
• 历史记录复用：当依赖上游历史时，网关强制 store=true 并透传必要的 ID 字段，确保多轮对话连贯性。

安全与依赖

• 项目严格遵循依赖安全规范（详见 docs/dependency-security.md）。
• 支持 TOTP 双因素认证加密，保障管理后台安全。

应用场景

1. 团队协作共享：公司购买少量企业版订阅，通过 Sub2API 分发给数十名开发者，按实际用量内部结算。
2. SaaS 服务后端：作为 AI SaaS 产品的中间层，统一管理上游多个账号池，实现用户计费和限流。
3. 个人多账号管理：个人拥有多个 Claude/OpenAI 账号，通过网关聚合，突破单账号速率限制，提升使用体验。
4. 成本分析与优化：通过后台报表分析哪些模型/用户消耗最大，针对性优化 Prompt 或调整配额策略。

体验地址：https://v2.pincc.ai/

演示账号（共享演示环境；自建部署不会自动创建该账号）：