一句话定位#

sub2api（Go + Vue + PostgreSQL + Redis + Docker）是 AI API 网关：把 Claude、OpenAI、Gemini、Grok 的订阅配额统一接进来，再用平台生成的 API Key 分发出去，原生工具（Claude Code 等）无缝使用。

双接入：OAuth 与 API Key#

上游账号两种形态：OAuth 订阅号（走订阅代理，如 Grok OAuth、Antigravity 授权）、API Key 号（直调官方 base_url）。/admin/accounts 就是管这些账号的地方：授权、刷新 token、启停——账号是耗材，管理账号的后台才是资产。

调度：groups + 粘性会话#

• Composite Groups：管理侧路由层，把请求的模型解析到具体供应商，多供应商混编一个分组
• 混合调度：Antigravity 账号可并入通用端点（/v1/messages、/v1beta/）一起调度
• 粘性会话：智能选账号，同会话尽量落同一账号，多轮对话不断片

多协议入口#

/v1/chat/completions、/v1/responses、/v1/messages（Claude 兼容）、/v1beta/（Gemini）、/antigravity/* 专用端点——协议兼容是中转站的生命线，客户端不用改一行代码就能切过来。

渠道管理的本质：账号会死，调度不死。