Sub2API：开源AI订阅转API网关，多账号聚合分发与Token精准计费平台

一、Sub2API是什么

Sub2API是一款完全开源免费的一站式AI订阅配额转化与API网关管理平台，核心逻辑是把各类原生AI订阅账号（包含Claude、OpenAI、Gemini等主流大模型订阅权益）统一收拢整合，转化为标准化、可分发、可管控的通用API接口，彻底打通个人订阅、团队共享与业务开发之间的接口壁垒。

简单来说，普通用户或企业采购了官方AI平台的会员订阅后，原生仅能在官方客户端使用，无法拆分权限、无法单独生成调用密钥、无法统计消耗成本，也没办法对接自有业务系统。而Sub2API就像一座专业的中转枢纽，集中收纳所有上游AI订阅账号，再向下输出统一规范的API服务，管理员可自主生成专属API Key分配给员工、客户或合作伙伴，每一次接口调用都会被精准记录、核算用量、限制权限，全程实现可视化管控。

该项目主打轻量化高性能设计，依托成熟稳定的后端与前端技术搭建，同时兼顾新手部署门槛与企业级运维需求，既支持个人自用搭建AI账号拼车分摊体系，也能满足中小企业、开发团队搭建私有AI接口中台、对外提供合规AI调用服务的核心需求。项目全程遵循MIT开源协议，使用者可自由部署、二次修改、商用落地，不存在版权绑定与授权纠纷问题。

二、功能特色

2.1 多类型上游账号全域兼容

Sub2API全面适配当下主流AI服务商的账号接入模式，同时支持OAuth授权登录与原生API Key绑定两种主流对接方式，能够批量收纳无数个上游AI订阅账号，搭建规模化账号资源池。无论是个人零散的会员账号，还是企业批量采购的企业级订阅权益，都能统一录入平台集中管理，实现多品牌、多账号、多模型的一站式聚合，无需单独对接每个AI厂商的接口文档。

2.2 自定义API Key分发与权限管控

平台内置完整的密钥生成体系，管理员可按需创建无数组独立API Key，每一组密钥都能单独划定使用范围。可精准限制单个密钥能调用的AI模型种类、单日最大调用次数、单轮对话Token上限以及并发请求数量，从根源杜绝账号超额消耗、违规滥用的情况。所有密钥支持随时启用、禁用、重置，权限调整实时生效，适配团队分级管理、客户差异化授权等各类场景。

2.3 Token级精准计费与用量追溯

区别于普通中转工具粗略统计调用次数，Sub2API实现了精细化到Token粒度的用量追踪与成本核算，每一次对话的输入Token、输出Token都会实时抓取记录，自动换算对应消耗成本。后台会生成完整的用量报表，涵盖每日消耗、单密钥消耗、单模型消耗、单上游账号消耗等多维度数据，同时支持充值码兑换、余额管控，完美适配成本分摊、按量计费、收益结算等商业化运营需求。

2.4 智能负载调度与会话粘性保障

当平台接入多个同类型上游AI账号时，系统会自动启动智能负载均衡调度机制，优先分配闲置余量充足、响应速度更快的账号承接请求。同时原生支持会话粘性功能，同一轮连续对话会固定绑定同一个上游账号，避免上下文丢失、对话逻辑断裂的问题，彻底解决多账号切换带来的交互异常，保障AI对话体验连贯流畅。

2.5 多层级限流并发防护

为保障平台长期稳定运行，项目搭载完善的风控防护能力，可从三个维度配置限制规则：一是针对单个用户API Key设置并发上限，防止单账号恶意高频请求；二是针对上游原生订阅账号设置并发阈值，避免触发厂商风控封禁；三是全局配置Token流速与请求频率限制，抵御恶意刷量、CC攻击等风险，全方位守护账号资源安全与服务稳定性。

2.6 全可视化Web管理控制台

配套Vue开发的现代化可视化后台面板，所有核心操作均可通过网页端完成，无需代码操作。管理员能够实时查看账号在线状态、接口调用实时日志、用量统计图表、密钥使用明细，同时支持一键配置调度规则、修改限流参数、导入模型定价数据。界面简洁易懂，操作逻辑清晰，零基础运维人员也能快速上手管理整个平台。

2.7 灵活生态拓展能力

项目预留丰富的外接拓展接口，支持通过iframe无缝嵌入第三方系统，可对接自助支付平台、工单客服系统、会员管理系统等。社区同步衍生出Sub2ApiPay支付插件、sub2api-mobile移动端管理端等配套工具，既能搭建纯内部使用的私有接口平台，也能快速改造为面向大众的商业化AI接口服务站点。

2.8 离线定价降级兜底

平台内置LiteLLM官方模型定价数据本地备份，当遇到网络中断、境外接口访问受限等异常情况时，会自动启用本地离线定价数据完成计费统计，不会出现用量核算中断、数据丢失的问题，保障计费体系全年稳定可用。

三、技术细节

3.1 核心整体架构

Sub2API采用前后端分离的经典高性能架构，整体分为三层逻辑：第一层是前端可视化交互层，负责所有管理操作、数据展示、密钥配置；第二层是后端核心网关业务层，承接接口请求、权限校验、账号调度、计费统计、流量管控；第三层是数据存储与缓存层，负责持久化数据保存与高频请求加速响应，三层架构解耦清晰，便于后期维护升级与功能拓展。

3.2 完整技术栈明细

项目选用行业成熟且轻量化的技术组合，兼顾性能、稳定性与部署便捷性，核心技术组件如下表所示：

后端依托Go语言天生高并发、低内存占用的优势，能够承载海量接口请求不卡顿；前端基于Vue搭建轻量化管理页面，加载速度快、兼容性强；PostgreSQL保障复杂用量数据精准存储，Redis实现高频调度与限流规则快速响应，整套技术栈适配单机小体量部署与集群大规模运维两种模式。

3.3 核心业务运行逻辑

用户通过自定义API Key发起AI接口调用后，请求会优先进入后端网关层，首先完成密钥合法性校验、权限范围核对、限流规则检测，校验不通过直接拦截并返回标准报错信息；校验通过后，调度系统会匹配可用上游账号池，结合会话粘性规则与负载余量筛选最优账号转发请求；AI服务商返回结果后，网关实时统计本轮Token消耗、更新余额与用量报表，同时记录完整日志，最终将标准化结果返回给调用用户，全程闭环无遗漏。

3.4 部署适配与CI/CD支持

项目原生兼容linux/amd64、linux/arm64两大主流服务器架构，无论是普通云服务器、ARM架构轻量机，还是本地虚拟机均可部署。同时接入GitHub Actions自动化构建流程，支持推送代码至主分支后自动打包镜像、推送仓库、部署至云服务平台，适配开发团队持续迭代、自动更新的运维需求。

3.5 反向代理配置规范

若搭配Nginx做反向代理落地使用，必须开启underscores_in_headers配置项，否则会话粘性相关的自定义请求头部会丢失，进而导致连续对话上下文断裂、调度异常，这是项目运维阶段关键的技术配置要点。

四、应用场景

4.1 个人与小众圈子AI账号拼车分摊

普通用户单独采购高端AI订阅会员成本较高，多人合租分摊性价比更强。借助Sub2API可将合租的订阅账号统一录入平台，为每个参与人员生成独立API Key，精准统计每个人的Token消耗，按照实际用量分摊费用，避免账目混乱、有人超额占用资源的问题，低成本享受顶级大模型调用权益。

4.2 中小企业私有AI接口中台搭建

企业采购多款AI服务商订阅后，可通过Sub2API搭建内部私有网关，统一整合所有大模型接口，研发团队无需对接多个厂商API文档，仅调用平台统一接口即可切换不同模型。同时能管控员工调用权限、统计业务研发AI用量，把控企业AI采购成本，保障内部数据不对外泄露。

4.3 技术开发者接口二次开发与业务集成

独立开发者、小程序开发团队、AI应用创作者，可依托Sub2API将原生订阅权益转为通用接口，快速集成到自有小程序、网站、客户端、办公工具中，无需自主对接复杂厂商接口，大幅降低AI应用开发门槛，快速落地各类智能化功能。

4.4 轻量化商业化AI接口服务运营

个人创业者、小型技术团队可基于Sub2API搭配拓展支付插件，搭建合规的付费AI接口站点，整合多品牌大模型资源，面向普通用户、小型工作室提供按量计费的API调用服务，依托精准计费与权限管控，实现标准化商业运营。

4.5 教育与实训场景AI资源管控

培训机构、高校实训实验室，可通过平台统一管理教学用AI订阅账号，为每位学生分配独立调用密钥，限制单日调用额度与模型范围，既满足教学实训需求，又能避免学生恶意消耗资源、违规滥用订阅权益。

五、使用方法

5.1 前期准备工作

部署前需提前确认服务器基础环境，推荐搭载CentOS、Ubuntu等主流Linux系统，硬件配置最低1核2G即可满足基础使用；若面向高并发商用场景，建议升级至2核4G及以上配置。同时提前规划数据库密码、JWT密钥等安全凭证，保障部署后账号与数据安全。

5.2 方式一：Docker单容器快速部署（新手首选）

这是最简单快捷的部署模式，无需复杂配置，一条命令即可启动核心服务，适配个人自用、快速测试场景。直接在服务器终端输入指定Docker运行命令，配置数据库与Redis远程连接地址，镜像会自动拉取、启动服务，端口默认映射8080，部署完成后通过服务器IP+端口即可访问后台。

5.3 方式二：Docker Compose完整编排部署（推荐商用）

该模式会自动编排Sub2API主程序、PostgreSQL数据库、Redis缓存三大组件，全程无需手动安装数据库与缓存服务。仅需下载官方docker-compose配置文件，修改环境变量中的数据库密码、JWT密钥、时区等核心参数，执行启动命令后，系统会自动完成容器创建、数据初始化、服务联动启动，全程可视化日志输出，便于排查启动异常，适合长期稳定商用运维。

5.4 方式三：原生脚本手动安装（专业运维）

针对熟悉服务器运维、需要深度自定义修改的用户，可选用官方Linux一键安装脚本，脚本支持amd64/arm64架构，自动下载GitHub发布的预编译二进制程序。需提前手动部署就绪PostgreSQL 15+与Redis 7+环境，配置好数据库连接信息后执行脚本，完成程序安装与服务常驻配置。

5.5 基础初始化与账号接入

服务部署启动成功后，打开网页端管理后台，使用初始管理员账号登录，第一时间修改默认密码强化安全防护。随后进入账号管理页面，添加上游AI订阅账号，选择OAuth授权或API Key绑定方式完成接入，等待系统校验账号有效性、同步可用模型与余量信息。

5.6 密钥创建与对接使用

账号池搭建完成后，进入密钥管理模块，新增自定义API Key，按需勾选可调用模型、设置并发上限与用量额度。生成密钥后，直接套用标准OpenAI接口格式，即可在各类客户端、开发工具中对接调用，全程无需额外修改代码，兼容绝大多数主流AI接入程序。

六、常见问题解答

Q1：Sub2API支持接入哪些AI大模型服务商？

A1：项目原生核心支持Claude全系列模型，同时兼容OpenAI、Gemini等主流大模型的订阅账号接入，后续还可通过版本更新拓展更多厂商适配，覆盖当下主流商用大模型品类。

Q2：部署之后忘记管理员登录密码该如何重置？

A2：可通过服务器终端进入项目数据库配置目录，执行官方提供的密码重置脚本，直接修改管理员账号密码；若使用Docker Compose部署，也可进入数据库容器手动更新用户数据表密码字段，操作全程贴合官方运维规范。

Q3：多账号接入后对话出现上下文丢失是什么原因？

A3：大概率是未开启会话粘性功能，或是Nginx反向代理未配置underscores_in_headers参数。优先在后台调度设置中开启粘性会话，若搭配反向代理，需在Nginx配置文件内添加对应参数并重启服务，即可解决对话断裂问题。

Q4：Token计费数据不准确、统计有偏差怎么办？

A4：首先检查网络连通性，确认主程序可正常联网同步官方定价；若外网访问受限，系统会自动启用本地离线定价兜底，基本误差可控制在合理范围。同时核对上游账号接口返回的Token原始数据，排查是否存在接口回调异常。

Q5：个人部署自用是否涉及版权问题，能否商用？

A5：项目整体采用MIT开源协议，个人自用、二次修改、商业化落地均完全合规，无版权捆绑。但需注意，接入的上游AI订阅账号需遵守对应厂商的用户协议，严禁违规破解、盗用官方订阅权益。

Q6：高并发调用时服务卡顿、响应变慢如何优化？

A6：优先扩容服务器硬件配置，升级CPU与内存；其次优化Redis缓存配置，加大缓存容量；同时合理上调单账号并发上限，扩充上游账号资源池分散请求压力，也可开启全局限流防止突发流量冲击。

Q7：能不能对接第三方支付系统实现自动充值续费？

A7：可以直接接入社区配套的Sub2ApiPay拓展插件，支持易支付、微信支付、支付宝、Stripe等主流支付渠道，通过iframe嵌入后台即可实现用户自助充值、余额自动到账，快速搭建商业化付费体系。

七、相关链接

• 开源仓库地址：https://github.com/Wei-Shaw/sub2api

• 官方在线演示体验地址：https://demo.sub2api.org/

八、总结

Sub2API是一款实用性极强、架构轻量化、部署门槛友好的开源AI订阅转API网关项目，精准解决了当下AI订阅账号无法拆分分发、用量无法精准统计、多账号难以统一管理、自研应用对接接口繁琐的核心痛点，凭借多账号兼容接入、Token级精细化计费、智能负载调度、会话粘性保障、多层级限流防护与全可视化后台的核心能力，既能满足个人用户合租分摊AI会员成本的刚需，也能支撑中小企业搭建私有AI接口中台、开发者集成开发AI应用、小型团队运营商业化接口服务等多元落地场景。项目依托成熟稳定的Go+Vue技术栈搭建，适配多类服务器架构与主流部署模式，搭配完善的官方文档与社区拓展生态，再加上宽松自由的MIT开源授权，让不同技术基础、不同使用需求的用户，都能快速完成部署配置与落地使用，成为当下AI订阅资源整合与接口分发领域高性价比、高实用性的优选开源解决方案。