Wei-Shaw/sub2api

项目概览

它把多类上游账户管理、平台 API 密钥分发、按令牌计费和请求路由集中在同一网关中，并提供管理界面与组合提供商路由，适合评估统一接入和运营管理需求。

项目类型

基础设施

部署方式

查看项目说明

License

LGPL-3.0

适合谁

• 需要统一接入和管理多个上游 AI 服务、账户及用户 API 密钥的运营团队。
• 需要网页管理界面、用量计费、账户调度或多提供商路由的开发和运维人员。

核心能力

• 管理包括 OAuth 和 API 密钥账户在内的多类上游账户，供网关使用。
• 为通过平台访问上游服务的用户生成和管理 API 密钥。
• 按令牌跟踪用量，并计算对应的平台计费成本。
• 智能选择上游账户，并支持请求路由中的粘性会话。
• 对网关流量设置按用户和按账户的并发限制。
• 配置网关请求速率和令牌速率限制。
• 通过 EasyPay、支付宝、微信支付和 Stripe 提供用户自助充值，且不需要单独部署支付服务。
• 提供用于监控和管理网关的网页界面。

限制与风险

• 网关依赖上游 AI 服务，项目自身不提供这些上游服务；采用前应确认所需服务和模型能够由外部上游提供。
• 在获得首个可用的上游响应之前，xAI 配额仍可能处于未知状态；需要将其纳入接入和运营检查。
• 使用 Nginx 反向代理并配合 Codex CLI 进行粘性会话路由时，需要进行特殊的请求头配置。
• 现有文档未明确项目的成本依赖，也未明确是否需要购买项目本身或相关外部服务；选型时应单独核实项目及上游服务的费用条件。
• 现有文档未记录项目的遥测行为；已知的令牌用量跟踪和成本计算不等同于对遥测范围的完整说明，采用前应核实相关数据行为。
• 采用前应检查 Anthropic 及其他上游提供商的服务条款，因为使用项目可能违反相关条款。
• 项目来源声明不对账户封禁、服务中断、数据丢失及其他直接或间接损害承担责任；部署前应将这些事项作为项目特定的采用检查。
• 项目来源明确禁止违法使用，并要求遵守适用法律法规；上线前应核对具体使用方式是否符合相关要求。

如何开始

• 先安装文档列出的前置依赖，再选择脚本安装或 Docker Compose 部署并启动服务；随后完成 Setup Wizard，配置数据库、Redis 和管理员账户，最后访问文档所述的服务器地址。

核验依据

• GitHub 项目简介: Sub2API 一站式开源中转服务，让 Claude、Openai 、Gemini、Grok订阅统一接入，支持拼车共享，更高效分摊成本，原生工具无缝使用。
• README: Sub2API is an AI API gateway platform designed to distribute and manage API quotas from AI product subscriptions. Users can access upstream AI services through platform-generated…
• README: **AI API Gateway Platform for Subscription Quota Distribution**
• Release: Sub2API 0.1.184
• README: | Backend | Go 1.27.0, Gin, Ent | | Frontend | Vue 3.4+, Vite 5+, TailwindCSS | | Database | PostgreSQL 15+ | | Cache/Queue | Redis 7+ | ---

来源更新时间：2026-08-31T18:30:34Z

打开原始 GitHub 项目