Sub2API 是一个面向 AI 产品订阅配额分发的开源 AI API 网关平台。其核心用途是让用户通过平台生成的 API Key 访问上游 AI 服务，平台负责认证、计费、负载均衡和请求转发，从而将 Claude、OpenAI、Gemini、Grok 等订阅统一接入，并支持拼车共享以分摊成本。
主要能力包括：多账号管理，支持 OAuth 和 API Key 两种上游账号类型；API Key 分发，可为用户生成和管理 API Key；精确计费，提供 Token 级用量追踪和成本计算；智能调度，支持粘性会话的智能账号选择；并发控制，可设置每用户和每账号的并发上限；速率限制，可配置请求和 Token 速率限制；内置支付系统，支持 EasyPay、支付宝、微信支付和 Stripe，用户可自助充值，无需单独支付服务；管理后台，提供 Web 界面用于监控和管理；复合分组，管理员路由层可将请求的模型解析到具体提供商，适用于多提供商分组；外部系统集成，可通过 iframe 嵌入外部系统（如工单系统）扩展管理后台。
使用方式上，项目提供多种部署方法。方法一为脚本安装（推荐），一键脚本从 GitHub Releases 下载预编译二进制文件，要求 Linux 服务器（amd64 或 arm64）、PostgreSQL 15+、Redis 7+ 和 root 权限；脚本会检测系统架构、下载最新版本、安装二进制到 /opt/sub2api、创建 systemd 服务并配置系统用户和权限，随后通过设置向导完成数据库、Redis 和管理员账号配置。方法二为 Docker Compose（推荐），包含 PostgreSQL 和 Redis 容器，可使用自动化部署脚本或手动配置 .env 文件，访问 http://YOUR_SERVER_IP:8080 即可。方法三为 Apple container（macOS），适用于运行 macOS 26 的 Apple 芯片 Mac，需 Apple container 1.1.0 或更新版本。方法四为从源码构建，用于开发或定制，需注意 -tags embed 标志用于嵌入前端。
适用场景包括个人开发者或内部团队快速接入（简单模式，设置 RUN_MODE=simple，隐藏 SaaS 相关功能并跳过计费流程）、多账号拼车共享、需要统一管理多个 AI 订阅配额、需要精确计费和支付集成的场景，以及通过异步图像任务接口处理长时间运行的 OpenAI/Grok 图像生成和编辑。Grok/xAI 支持方面，平台支持通过 xAI OAuth 的 Grok 订阅账号和标准 xAI API-key 账号，两者均将 OpenAI 兼容的 Responses 流量转发至 xAI，支持 /v1/responses、/responses、/backend-api/codex/responses、/v1/messages、/v1/chat/completions 等目标，以及 grok-4.5、grok-4.3 等文本模型和图像、视频生成目标。
限制与注意事项：使用本项目可能违反 Anthropic 等上游提供商的服务条款，用户需自行承担风险；项目仅供技术学习研究，作者不对账号封禁、服务中断、数据丢失等负责；开发者未授权任何商业运营。安全方面，当 security.url_allowlist.enabled=false 时系统允许 HTTP URL，生产环境应仅使用 HTTPS；Nginx 反向代理需注意默认丢弃含下划线的头部（如 session_id），可能破坏粘性会话路由；初始管理员账号仅通过设置向导创建，config.yaml 中的 default.admin_email/default.admin_password 不用于创建账号；简单模式生产环境需设置 SIMPLE_MODE_CONFIRM=true 才允许启动。
