一、上游多类型账号接入（项目独有核心能力）

Sub2API 最大特色：兼容两种上游接入模式，网页订阅 + 官方 API Key 双适配
  1. 网页订阅账号接入（核心亮点）
  • 支持 ChatGPT Plus、Claude Pro、Gemini Advanced 网页会员，导入 Cookie、Session、OAuth 凭证即可接入，无需官方 API 密钥；
  • 自动维持浏览器会话保活，定时检测 Cookie 有效性，凭证失效自动标记下线、剔除账号池；
  • 单平台批量添加数十个订阅账号，实现多会员资源池整合，分摊订阅成本。
  1. 标准 API 密钥接入

    兼容 OpenAI、Claude、国产大模型官方 API Key，可和网页订阅账号混合在同一个资源池调度。

  2. 多厂商全覆盖

    原生适配 OpenAI 全系列、Anthropic Claude 全系、Google Gemini、Antigravity 等主流大模型，支持对话、绘图、函数调用、多模态上传解析。

  3. 模型自定义映射

    自定义上游账号可用模型列表，单独禁用某账号 GPT4o、Claude3 等高消耗模型，按需隔离资源。

二、智能调度与会话管控（对话优化核心）

  1. 四种调度策略

    随机分发、权重轮询、最少负载优先、粘性会话（Sticky Session），同一条连续对话固定路由至同一个上游订阅账号，杜绝上下文丢失，适配 Claude Code、代码调试等长会话场景。

  2. 账号自动熔断故障切换

    上游账号风控封禁、限流、会话失效，系统自动剔除账号池，请求无缝切换至备用账号，保障服务不间断。

  3. 分层限流管控
  • 上游账号层：单订阅账号设置最大并发数、每秒请求 QPS、单日 Token 上限，防止网页账号被官方风控封号；
  • 下游用户层：单个用户 API 密钥配置并发、QPS 上限，避免恶意刷空订阅额度。

三、下游用户与密钥权限管理

  1. 多角色分级体系：超级管理员、普通管理员、注册用户三级权限，管理员管控全平台，用户仅可管理自身密钥与账单。
  2. 自定义下游 API Key

    后台批量生成用户专属调用密钥，支持自定义密钥前缀、设置密钥有效期、额度上限；密钥泄露可一键单独封禁，不影响全平台账号池安全。

  3. 模型黑白名单

    针对单个用户禁用指定模型，比如普通用户只能调用 GPT3.5，高权限用户开放 GPT4/Claude3。

  4. 自助注册开关

    后台一键开启 / 关闭前台自助注册，新用户自动赠送免费试用额度，用于站点引流。

四、Token 级精细化计费与商业化体系（商用必备）

  1. 精细化定价规则

    每个模型分开设置输入 Token 单价、输出 Token 单价，可设置倍率加价，区分自用成本价、对外售卖售价。

  2. 实时扣费机制

    请求结束实时统计消耗 Token，自动扣减用户账户余额，扣费明细实时留存。

  3. 卡密系统

    批量生成自定义面值充值卡密，线下发卡、用户前台自助兑换余额，适配代理分销模式。

  4. 内置在线支付

    原生集成微信、支付宝、Stripe 支付通道，用户前台自主在线充值余额，无需二开对接第三方易支付。

  5. 成本分摊统计

    自动核算上游订阅总成本、全平台总收入，单账号消耗账单单独统计，方便拼车合租场景均分会员费用。

五、全维度数据统计、日志与财务账单

  1. 可视化大盘看板

    首页展示当日总调用次数、全量 Token 消耗、在线活跃用户、上游账号使用率、营收数据图表化展示。

  2. 分层账单明细
  • 用户账单：单用户全周期调用记录、扣费明细、使用模型、消耗 Token 明细；
  • 上游账单：单个订阅账号 / API 密钥总消耗，核算采购成本；
  • 全局账单：全平台收支汇总、充值记录、卡密核销记录。
  1. 全量请求日志检索

    按时间、用户密钥、模型名称、上游账号筛选调用日志，快速排查报错、异常高额消耗。

  2. 数据导出

    账单、用量日志支持 Excel 导出，满足财务对账需求。

六、统一 API 协议兼容（下游全客户端适配）

  1. 全兼容 OpenAI 接口规范

    对外统一/v1/chat/completions标准接口，支持流式 SSE 输出、非流式问答、Function Call 函数调用、图片多模态，所有 ChatGPT 类客户端、AI 网页、IDE 插件无需改代码直接接入。

  2. 格式自动转换

    Claude、Gemini 原生非 OpenAI 协议，系统后台自动封装转 OpenAI 格式，下游调用格式统一。

  3. 自定义接口域名

    可修改网关接口路由地址，隐藏默认路径，提升站点防扫描安全性。

七、前台用户自助站点功能

  1. 个人中心：注册登录、查看自有 API 密钥、实时剩余余额、历史消费账单。
  2. 模型价目展示：前端展示全平台可用模型、各模型 Token 单价，用户按需选型。
  3. 充值专区：在线支付充值 + 卡密兑换双渠道。
  4. 接口文档：内置对接示例代码，一键复制接口地址 + 密钥快速接入应用。

八、系统配置、部署与拓展能力

  1. 基础站点配置：网站名称、LOGO、首页公告、客服联系方式、站点开关配置。
  2. 数据库选型：支持 PostgreSQL 正式商用部署、搭配 Redis 做缓存与会话存储，Docker 一键容器化部署。
  3. Nginx 反向代理适配：轻松绑定域名、配置 SSL 证书实现 HTTPS 访问。
  4. 上下游联动拓展
  • 可作为下游接入 NewAPI/OneAPI 标准 API 渠道；
  • 可作为上游网关，对接各类 AI 前端网页（ChatUI、自定义对话站点）。
声明：本站全部开源内容严格依照 MIT、Apache 2.0、BSD、WTFPL 开源协议分发。平台所提供的技术教程、项目搭建服务属于有偿服务，附带的快速构建文件仅为辅助工具，本平台不以售卖源码作为经营内容。资源下载链接仅为提升用户获取便利性而设置。如原作者更改协议相关内容，导致侵犯权利人合法权益，请权利人及时联系本站，我们将立即处理。