tosky.io 维护的 Sub2API 独立分支
按需同步上游更新，扩展实用功能，独立发布生产版本。
欢迎正在部署、使用或维护 Sub2API 的朋友加入 QQ 群「中转技术交流」（群号 1004036018），交流部署实践、协议兼容、出口代理和功能改进。也欢迎参与问题复现、测试、文档补充和 Pull Request，一起维护这个独立分支。
加入 QQ 群「中转技术交流」 |
如果帮到大家可以打赏咖啡！ |
二维码长期有效。需要长期留档、报告问题或讨论具体改动时，请使用 Issues。
新人部署、官方版替换、Excel / BPS 配置、780 / 292 打票边界和“降智”运维步骤，请阅读新人入门文档。
已经托管账号或完成部署，想在 Codex 中使用？请阅读新人入门：使用 Sub2API 接入 Codex，按步骤创建 API Key、配置 Cockpit Tools 并验证调用。
本仓库是 ranxi2001/sub2api 的独立生产 fork，基于 Wei-Shaw/sub2api 按需同步。应用功能、上游修复、Release 和生产验证都以 production 分支为准；不会用上游默认分支或 tag 直接覆盖本 fork 的生产历史。
- DeepSeek 与 Codex 适配：支持 Responses 到 Chat Completions 的转换、工具调用历史和上下文压缩兼容。配置模型映射后，可通过切换 API Key 分组使用 DeepSeek，沿用客户端配置。操作教程
- Codex ticket 管理：提供后台采集、注入、模型选择及账号状态展示；相关开关和采集代理由管理员配置。
- Mihomo 出口管理：集成采集出口管理、票据刷新策略和节点状态操作，日常业务代理与采集出口分别配置。
- Excel / Basispoints：维护模型级 BPS 路由、内嵌图片 HTTPS 中转、磁盘和并发保护、结构化输出校验，以及工具历史和 transport 恢复。开启 BPS 且账号未因 403 自动关闭时，请求强制走 BPS；不支持的能力会由 BPS 返回错误，不再静默回退原 Codex 通道。
- 上游修复维护：持续跟踪上游 Codex、Responses、工具调用、密文恢复和限流修复；先确认与本 fork 的行为差异，再按提交级别移植并补充回归测试。
- 独立发布与升级：使用
ranxi2001/sub2api的 Release、安装资源和容器镜像。版本变更见 更新说明；Release 成功不代表生产服务已经部署，线上状态需要单独验证。
贡献代码时，请在独立分支中说明影响的请求路径、账号类型、配置默认值和兼容边界。涉及生产分支的修复应先进入原 PR head，通过 CI 后再合并；不要提交 Token、OAuth 导出、ticket、代理凭据或生产配置。
Sub2API 是一个 AI API 网关平台，用于分发和管理 AI 产品订阅的 API 配额。用户通过平台生成的 API Key 调用上游 AI 服务，平台负责鉴权、计费、负载均衡和请求转发。
- 多账号管理 - 支持多种上游账号类型（OAuth、API Key）
- API Key 分发 - 为用户生成和管理 API Key
- 精确计费 - Token 级别的用量追踪和成本计算
- 智能调度 - 智能账号选择，支持粘性会话
- 并发控制 - 用户级和账号级并发限制
- 速率限制 - 可配置的请求和 Token 速率限制
- 内置支付系统 - 支持 EasyPay 易支付、支付宝官方、微信官方、Stripe，用户自助充值，无需独立部署支付服务（配置指南）
- 管理后台 - Web 界面进行监控和管理
- 外部系统集成 - 支持通过 iframe 嵌入外部系统（如工单等），扩展管理后台功能
| 组件 | 技术 |
|---|---|
| 后端 | Go 1.27.0, Gin, Ent |
| 前端 | Vue 3.4+, Vite 5+, TailwindCSS |
| 数据库 | PostgreSQL 15+ |
| 缓存/队列 | Redis 7+ |
| API 协议 | OpenAI Responses / Chat Completions、Anthropic Messages、Gemini、SSE、WebSocket |
| 调度与可靠性 | 粘性会话、并发控制、限流、故障转移、ticket 准入与冷却 |
| 观测与运维 | 结构化日志、请求分段耗时、健康检查、Mihomo 出口与 systemd |
| 交付与质量 | Docker Compose、GitHub Actions、Go 单元测试、前端类型检查与构建 |
欢迎围绕协议兼容、账号调度、Codex ticket、支付计费、管理后台和运维观测提交改进。高质量贡献应尽量保持边界清晰，并在 PR 中说明请求路径、状态变化、兼容性影响和验证证据。
开始前请阅读 贡献指南：包含最小复现、日志脱敏、开发环境、验证命令和 PR 流程。提交 Issue 时可选择 Bug、功能建议、文档或使用问题表单；提交 PR 时按模板填写行为变化和实际验证结果。
建议按以下方式提交：
- 协议与网关：补充请求/响应样例，覆盖流式终止、工具调用、重试和上游错误映射。
- 调度与账号：说明候选筛选、粘性状态、并发占用、冷却窗口和故障转移行为，避免改变幂等语义。
- 后台与配置：同步前后端类型、默认值、权限边界和迁移兼容性。
- 运维与部署：提供离线或 mock 验证，不在 PR 中写入 Token、ticket、代理凭据或生产配置。
- 验证与审查：列出实际运行的测试、构建或脚本检查；未运行的检查不要标记为通过。
感谢已合并 PR 的贡献者（按本仓库已合并 PR 数量降序排列，数量相同时按 GitHub 用户名排序）：
使用本项目前，请务必仔细阅读以下内容：
- 🚨 服务条款风险：使用本项目可能违反 Anthropic 等上游服务商的服务条款。请在使用前仔细阅读相关服务商的用户协议，由此产生的一切风险由用户自行承担。
- ⚖️ 合规使用：请在符合您所在国家或地区法律法规的前提下使用本项目，严禁将其用于任何违法违规用途。
- 📖 免责声明：本项目仅供技术学习与研究使用，作者不对因使用本项目导致的账户封禁、服务中断、数据丢失或其他任何直接或间接损失承担责任。
- 🚫 无商业授权：本项目从未授权任何个人或组织基于本项目开展任何形式的商业化运营。任何以本项目名义或基于本项目从事的商业行为均与本项目及其开发者无关，由此产生的一切纠纷、损失和法律责任由行为主体自行承担。
本项目基于 GNU 宽通用公共许可证 v3.0（或更高版本）授权。
Copyright (c) 2026 Wesley Liddick
如果觉得有用，请给个 Star 支持一下！