Skip to content

Sub2API 2.21.6

Latest

Choose a tag to compare

@github-actions github-actions released this 16 Nov 21:24

AI API Gateway Platform - 将 AI 订阅配额分发和管理

本版新增 OpenAI 账号按请求多代理分流、用户当前并发/RPM 展示,补齐 HTTP/WS 历史恢复、模型目录、结构化输出和 TOTP 绑定处理。多代理与有损续接均需明确配置,不会因升级自动启用。

账号代理与用户负载

  • 普通 OpenAI OAuth、BPS,以及已绑定独立 SIWC grant 的普通父账号,可在原代理字段切换单代理或按请求分散。手选代理组内优先分配给在途较少的出口,忙时可复用;同一请求及其触发的刷新、附件和允许的回退保持同一出口。无有效组内出口时明确失败,不改走直连或组外代理。
  • 修复选好请求出口后管理员切回 single 时,刷新可能走旧单代理或直连的问题。现在会在 token/JWKS 发送前拒绝模式变化,完成或失败后释放租约。代理列表新增关联账号、搜索、批量选择与连接测试,并补齐删除保护。
  • 用户管理新增「并发 / RPM」列,显示实际占用和上限;不限额显示 ∞,仍记录使用量。页面与该列可见时每分钟刷新当前页。RPM 是自然分钟的限流计数,可能包含限流拒绝,不等同于成功请求数;分组检查已拒绝的请求不进入用户级计数。

按请求代理仅支持已有 HTTP/SSE 入口,不增加真实 WebSocket、SIWC Images 等协议能力;账号总并发和上游额度不变,分配在单实例内完成,不承诺吞吐提升或公网 IP 唯一。详见账号代理说明。

HTTP / WS 续接与诊断

  • 补齐 WS 可读 agent、compaction、工具历史和继承模型场景的续接处理,修复未发送增量、响应归属、HTTP 桥残留历史和后续轮错误采集问题。
  • 新增默认关闭的 gateway.openai_ws.client_history_recovery_enabled,将客户端提供的完整工具历史作为未验证数据处理,不授予工具执行或归属证明。
  • 新增默认关闭的 gateway.openai_ws.lossy_history_restart_enabled;还需开启已有 openai_409_omit_encrypted_history_enabled。它在发送前移除供应商指针、密文及不兼容输入,保留可读文本;工具记录仅作为文本。媒体和不可读历史可能丢失,只有密文时会明确要求重新提供任务。它不自动重放已发送生成,也不保证消除所有 409。详见有损续接说明。
  • 修复 pending 等待结束时将独立存储故障误报为仍在等待的问题,保持存储错误与上下文截止/取消的诊断边界;补齐 BPS 搜索协议与工具证明处理。

模型、格式与账号维护

  • 补齐 gpt-6.2-astra、gpt-6.2-astra-pro、gpt-6.2-sol 的独立目录、别名、默认价卡和推理强度,保留显式 max。渠道自定义价格和上游能力元数据继续按原规则优先;目录声明不表示供应商实测支持。见模型说明。
  • Gemini 的 Chat Completions 兼容入口保留 json_object / json_schema 输出约束;无效格式、当前不支持的工具或图片组合在调用上游前明确拒绝,不再静默丢弃 Schema。此项参考上游 PR Wei-Shaw#8662,并补充本 fork 的边界处理。见结构化输出说明。
  • 增加独立的免费 UltraFast 分组开关:启用后客户按 Standard 价格计费,上游成本及服务档位支持仍按实际通道处理;默认关闭。OAuth 首次自动配置支持配置 API Key 账号的调度处置。
  • TOTP 登录、轮换和恢复记录绑定明确的 factor ID,持久化确认后再激活,使用有限匹配和明确的错误分类。成功表示选定验证器已验证保存,不代表旧验证器撤销;外部 Session Studio 不因本地 runtime 更新而自动具备同样行为。详见TOTP 绑定与恢复。

升级与维护说明

  • 新增 381_group_free_openai_ultrafast.sql 和 382_openai_totp_binding.sql。升级前备份数据库、配置与加密密钥;回退二进制不会撤销迁移或已经保存的代理配置。
  • 使用 request 代理的多实例应统一升级。回退到不识别新配置的版本前,先排空请求并明确切回有效 single,或停用相关账号。
  • CI 按前端、后端及辅助模块的实际输入选择检查;相同输入和 job 定义可复用已有成功结果。清理历史工作流,主前端检查与发布构建使用 GitHub runner 和 6 GiB Node 堆;未运行或取消的检查不会标记为通过。
  • 本版复用各 PR 已通过的未变代码验证,并执行新增修复的定向回归和正式产物构建;不将隔离验证等同于真实供应商验收。发布不代表线上已升级。

完整版本差异:v2.21.5…v2.21.6


📥 Installation

Docker:

# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.21.6

One-line install (Linux):

curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.21.6/deploy/install.sh | sudo bash -s -- install -v v2.21.6

Manual 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.21.6/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.21.6

Defaults: namespace tosky-canary, Deployment tosky-nerd; override with --namespace NAME --deployment NAME.
Upgrade every instance sharing Redis to this release.

📚 Documentation