ranxi2001/sub2api v2.21.0

Sub2API 2.21.0

on GitHub

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

本版新增千问独立平台、官方 Responses 会话缓存与严格会话粘性，并整合上游 v0.2.21。鹈鹕测试可使用同轮一致的随机 SVG 题库；VIP 自动垫付、账号导入和故障处置也有更新。

千问平台与缓存

• 新增「千问 Qwen」平台，支持 API Key、自定义兼容地址、模型映射和上游模型同步；账号、分组、用量、额度及监控独立归属。新建账号默认不限制模型，已有 OpenAI 账号和分组不会自动迁移。
• 新建和编辑千问账号时，可开启官方 Responses 会话缓存，并选择 Token Plan 或官方按量付费地址。开启后保留 previous_response_id、store 和输出上限，添加官方缓存请求头；客户端仍需按上游规则续接，不能保证所有请求命中。
• 可开启严格会话粘性：同一会话固定原账号，满载等待；原账号重试失败、停用或不可用时返回错误，不跨渠道回退。并发首轮通过共享缓存确认唯一归属，避免两个账号同时接走同一会话。绑定到期后可重新分配。
• 缓存与严格粘性两个开关默认关闭，旧 Chat Completions 行为保留。补齐嵌套缓存写入 Token 解析，缓存写入与命中分别统计。原 OpenAI 千问分组可通过 gateway.openai_scheduler.strict_session_affinity_group_ids 配置同样的严格策略，默认空数组。

详情：千问缓存与会话说明，相关 #798、#802。

鹈鹕、VIP 与账号运营

• 鹈鹕 SVG 测试新增四道随机题。手动比较可在同一轮复用题目，账号和分组定时测试按计划执行时间固定题目；结果保存题目版本、轮次、提示词和判据快照。默认仍为自定义模式，不新增自动评分。#800
• VIP 自动垫付可按用户开启成功邮件，默认关闭；配置保存不发信、不补发历史通知。充值记录补全 VIP 垫付金额、前后余额及收款状态，收款登记不会重复增加余额。#790、#799
• OpenAI 2FA 批量导入最多三条完整流水线并行，保持每个账号内部顺序和输入结果顺序，取消后不再新增任务。#787
• 降智处置增加独立的 429 条件；探针条件和 HTTP 条件可分别选择。优先调度统一复用账号性能数据，并改进默认分组选择。OAuth 兜底只统计可归因于 OpenAI OAuth 的请求，避免兼容 API Key 服务异常误触发。#796、#791、#797

兼容性与上游整合

• 整合上游 v0.2.21 的 Claude 5.2、OpenAI 缓存写入生命周期计费、WS/SSE、请求体内存预算、认证与协议兼容、价格同步、EasyPay 退款和管理界面更新；保留 fork 的计费、恢复和运营定制。来源与逐项核对见 #789。
• 托管 BPS 授权连接遇到临时 5xx 时不再冷却整条连接；该请求仍返回错误，其他鉴权和限流处理沿用原规则。#786
• 增加默认关闭的可信 OAuth 中转 Fast 计费兼容选项；特定账号可启用单参考图 edits 表单适配，默认关闭、多参考图明确拒绝。#794、#792
• 构建工具链升级到 Go 1.27.4，修复相关安全扫描问题。#788

升级说明

• 相对 v2.20.5 新增消费查询索引、缓存写入生命周期字段及 VIP 邮件 outbox 迁移。升级前备份数据库；首次启动的索引构建可能延长就绪时间。二进制回滚不会撤销已提交的数据库迁移。
• 千问严格粘性要求稳定会话身份，共享 Redis 的处理节点应保持同版本与配置。严格模式会放弃跨渠道故障回退，可能增加原渠道故障时的失败率；缓存写入可能产生上游费用，价卡需与实际协议匹配。
• 发布产物和 CI 验证不等于生产已部署，也不保证真实上游的缓存率、速度或套餐额度。正式发布不会自动开启上述可选功能。

完整变更

📥 Installation

Docker:

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

One-line install (Linux):

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

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

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

📚 Documentation

• GitHub Repository
• Installation Guide