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。
上游 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.0One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.22.0/deploy/install.sh | sudo bash -s -- install -v v2.22.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.22.0/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.22.0Defaults: namespace tosky-canary, Deployment tosky-nerd; override with --namespace NAME --deployment NAME.
Upgrade every instance sharing Redis to this release.