AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版为 OAuth 新账号增加首次模型范围与可选的 429 后自动更换 2FA，生图请求支持按分组延长响应头等待；同时加入 API Key 风险巡检、DeepSeek 网页搜索，并改善 Mistral 和 Responses 兼容路径。
新账号配置与生图等待
- 首次模型选择（#724）：在「智能运维 → 自动配置 → OAuth 账户首次配置」勾选同平台模型或添加具体名称。默认未配置，保持旧行为；全不选会明确禁止新账号的所有模型。模型映射源、目标、compact 和自动同步均受账号快照约束，修改全局模板不追溯已有账号。手动接管模型范围后可恢复常规模型管理。详见自动配置说明。
- 429 后自动更换 2FA（#726）：默认关闭，仅随首次配置复制到之后新建的 OpenAI OAuth 父账号。需要已加密保存且身份匹配的登录凭据和支持 2FA 的在线 Worker；任务沿用原有更换与恢复流程，数据库互斥和一小时冷却防止重复创建。不会把更换成功视为配额恢复，原有限流与冷却继续执行。详见2FA 更换说明。
- 分组生图超时（#714）：系统设置可为选中 OpenAI 分组的生图、改图请求设置更长的响应头等待，默认 180 秒。只有全局超时已启用且生图时限更长时生效；默认不选择分组，其他请求继续使用全局规则。已经收到响应头的 SSE 不受这一计时器截断。
风险提醒、搜索与运维
- API Key 风险巡检（#717）：管理员可从 IP 审计查看跨用户共用出口、单 Key 多来源等证据，手动通知、忽略或解决记录。默认只观察，自动风险邮件和超龄轮换提醒关闭，不自动吊销 Key 或封禁请求。风险提醒默认每个事件代次、每位用户最多尝试 3 次，实际尝试间隔至少 24 小时；客户可在 API 密钥页面确认知晓，暂停本事件对自己的后续提醒。巡检仅覆盖已记录用量的请求，高流量超过样本上限时会提示覆盖不完整。详见密钥巡检说明。
- DeepSeek 网页搜索（#723）：Web Search 模拟新增 DeepSeek 独立 Search API 服务商，需管理员配置 API Key。沿用现有代理、配额及测试入口，查询限制为 1–128 个 Unicode 字符；返回搜索结果与摘要，不抓取完整网页。
- AI 运维与利润查询（#706、#705）：诊断首屏聚焦范围、费用确认、开始和报告，明确显示冷却与提交状态，历史和原始证据可展开；保留生产控制边界。大数据量利润查询放宽时限并减少不必要聚合字段。
网关与兼容修复
- Mistral 请求与预算（#720）：按最终映射模型规范推理档位，清理不兼容历史字段；官方 Mistral API Key 可探测 Vibe/API 预算并展示月度快照。402 进入可恢复冷却，预算恢复或 PAYG 开启后可由探测恢复；账单权限不足与认证失败分开报告。详见Mistral 兼容说明。
- 模型目录并集（#718）：多分组 API Key 返回其授权分组的模型目录并集，同时保留客户端策略、复合路由和分组权限限制。
- Anthropic 兼容故障转移（#725）：Chat Completions 首段输出前最多暂缓转发上游 ping 30 秒，窗口内收到流内错误时仍可换号；Chat Completions / Responses 非流式不再把这类错误忽略或返回截断成功。安全拒绝和已输出内容后的处理保持既有边界。
- 调度与请求解析（#712、#707、#708、#709、#716）：减少调度快照发布锁竞争及请求体、会话元数据的重复扫描与分配；保留已提交账号状态和原有请求语义，未据此声明生产性能提升幅度。
- 精选上游 v0.2.20 修复（#722）：改善 OAuth / OpenAI SetupToken 非流式 Responses 的 SSE 聚合与终态 JSON，保留 reasoning 和消息字段；包含 Gemini/Antigravity 流式与 schema、Kimi 并发冷却、Bedrock 帧长度校验、Grok 输入以及鉴权断连和非法 UTF-8 处理。按叶提交引入，保留 fork 定制；未把整版上游行为全部并入。缺少合法终态的 EOF 聚合仍有既有限制。
升级注意
- 相对
v2.19.9新增数据库迁移333_key_risk.sql、334_key_risk_delivery_evidence.sql、336_key_risk_acknowledgements.sql。升级前备份数据库；回退二进制不会撤销通知尝试、客户确认或已经更换的上游 2FA。 - 首次模型范围和 429 自动更换均需管理员启用，模板只影响未来新账号。旧二进制会忽略新的模型范围快照，空范围账号可能恢复默认支持；回退前须停用需要维持限制的账号。处理未完成的 2FA 任务并保留加密 key 与恢复档案。
- 生图超时设置新增 JSON 字段，旧二进制保存此设置可能丢失新字段。更长等待会增加请求资源占用；生产实例及相关 Worker 应协调升级。
本次发布 GitHub Release、镜像和下载产物，未执行生产部署、真实上游调用、生产邮件或 2FA 更换。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.20.0One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.20.0/deploy/install.sh | sudo bash -s -- install -v v2.20.0Manual download:
Download the appropriate archive for your platform from the assets below.
K3s gateway upgrade (on each existing single-node host):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.20.0/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.20.0Defaults: namespace tosky-canary, Deployment tosky-nerd; override with --namespace NAME --deployment NAME.
Upgrade every instance sharing Redis to this release.