github ranxi2001/sub2api v2.22.0
Sub2API 2.22.0

37 minutes ago

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

v2.22.0 完整引入上游 v0.2.22,并修复开启 409 恢复后工具历史、动态发现目录及后续调用丢失的问题。需要多轮工具续接、分组 Ultra Fast 或 Vertex 多区域接入的部署者可关注本版。

工具续接与请求完整性

  • 修复有损续接将工具调用和结果转成普通 user 文本、遗漏 tool_search_output 中工具定义的问题。工具声明、function/custom 调用与结果、MCP 发现和审批、未知协议内容保留结构;WebSocket 全部退出有损文本转换路径。
  • 修复 API Key 后续请求只在发现目录中携带 namespace 时,调用项的 namespace 被清除的问题。保留发现目录、schema、调用 ID 和回程工具名称,覆盖原客户端会话内连续多轮调用。
  • 为发现目录恢复补充实际交付证明和目录回执,校验作用域、模型、原账号、待完成交付和并发更新;历史工具结果不会因为恢复而被自动重新执行。
  • 修复原生压缩对空 owner 的解引用,以及时区规范化与受保护历史之间的冲突。压缩输入保留原协议,无法确认归属时返回明确错误。
  • GPT-6.1 Sol 不再自动补入整段 Codex 默认提示词;仍遵循客户端明确提供的 instructions。

以上来自 #901、#895 和 #898。

上游 v0.2.22 同步

通过 #900 完整引入上游相对 v0.2.21 的 108 个非合并提交及 2 个前置依赖,再追加 fork 兼容修复。主要变化包括:

  • 分组支持按模型能力强制 Ultra Fast,可与强制 Fast 配置并存;透传账号可选择按模型筛选。
  • Vertex 多区域端点、Gemini 4 Carbon 与结构化输出兼容。Vertex 多区域的 10% 调整仅作用于默认价格路径,不在管理员自定义价卡上再次叠加。
  • 修复工具 schema 正则、patternProperties、additionalProperties 和嵌套 schema 清洗;保留加密函数调用内容和 additional_tools 声明 ID。
  • 改善配额窗口及新套餐解析、刷新失败时的配额时间戳、限流恢复、流中断错误和实际响应模型记录;区分 Bedrock 账号、额度、限流及内容过滤错误。
  • 分组日汇总重建与保留期清理减少对用量写入的阻塞;修复时区与夏令时日界线、分组倍率/RPM 事务更新和稳定退款请求 ID。
  • 引入按调度 bucket 合并加载、请求体和流事件解析优化。保留 fork 的撤销校验、嵌套配置隔离、持久化计费 journal、DeepSeek 压缩和 292 ticket 路径;本版不将上游性能数据作为 fork 的实测结果。

管理与运营

  • 账号可编辑为兼容平台,切换时核对凭据兼容并保留表单草稿,避免旧平台字段污染新配置。
  • API Key 按选定时段用量排序,复用相应查询限流;区域 Live 并发/RPM 在不可用、过期或部分读取失败时明确表示未知,避免展示误导数据。
  • 修复发布验收中的调度模拟账号初态,并为完整 repository 回归补齐隔离 PostgreSQL、Redis 和固定迁移基线。

升级注意

  • 409 Beta 默认关闭。有损文本模式 gateway.openai_ws.lossy_history_restart_enabled 也默认关闭,两者是独立设置。需要保留 Agent 工具语义时,应保持有损模式关闭;本次工具修复不要求开启它。
  • 正常 409 恢复仍可能省略无法读取的旧加密历史。交付未确认、目录被篡改、归属不兼容或缺少可信记录时继续拒绝;不能承诺所有旧会话都能恢复或全部上游 400/409 消失。
  • 新增迁移 251_group_force_openai_ultrafast.sql 与 251_group_usage_rollup_nonblocking_build.sql。升级前备份数据库、配置及加密密钥;二进制回退不会自动撤销字段、触发器或日汇总状态。
  • 多实例共享 Redis 时应统一升级,尤其是使用工具发现恢复和快照调度的实例。
  • 正式发布、测试通过与线上安装是不同状态;本说明不代表已将 v2.22.0 安装到各站点。

完整版本差异


📥 Installation

Docker:

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

One-line install (Linux):

curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.22.0/deploy/install.sh | sudo bash -s -- install -v v2.22.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.22.0/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.22.0

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

📚 Documentation

Don't miss a new sub2api release

NewReleases is sending notifications on new releases.