Sub2API 2.8.14
·
441 commits
to production
since this release
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版重点改善 Excel / BPS 的并发准入、代码工具调用和限流处理,新增账号工具往返探测,并修复请求采集与用量展示问题。
Excel / BPS
- 图片中转容量可配置:在「系统设置 → 功能开关 → Excel / BPS 图片中转」中调整请求体上限、共享资源预算和最大在途请求数,保存后对新请求生效。未知长度与压缩请求按读取后的实际正文大小保留预算,减少小请求因预留过大而触发的
basispoints_image_request_busy503。#83 - 图片中转默认在途请求数从 32 调整为 128,默认共享预算从 512 MiB 调整为 1024 MiB;在途请求数可配置范围扩展为 1–512。#91
- 实际准入预算取「配置的共享预算」与「在途上限 × 8 MiB」的较大值,避免提高并发后仍被原有预算提前限制。例如 128 槽至少对应 1024 MiB,512 槽至少对应 4096 MiB。该预算用于资源记账,不会预先分配等量内存。
- 新默认值适用于新安装及尚未保存相关字段的实例。已有明确保存的容量配置保持原值,需要在设置页手动调整。
- 代码工具参数传输修复:声明了字符串
code参数的工具可直接传递代码原文,减少 PowerShell 引号、多行代码和 Windows 路径在嵌套 JSON 中被重复转义或破坏的问题;其余工具参数继续保留。#87 - 用量快照与 429 冷却:BPS 成功响应携带有效用量头时更新账号的 5h / 7d 快照;收到 HTTP 429 后,根据上游重置时间或已有默认回避设置进入冷却,减少后续请求继续命中被限流账号的情况。冷却不永久停用账号,到期后恢复调度资格。#89
- 可选的 403 自动关闭:账号编辑页新增「遇到 BPS 403 时自动关闭协议」,默认关闭。启用后,符合条件的 BPS 上游 HTTP 403 会关闭该账号的 BPS 协议开关,保留账号本身和其他配置;当前失败请求不会自动重放。#84
- 账号工具往返探测:已启用 BPS 的 OpenAI OAuth 账号,可在连接测试中选择「BPS 工具往返」,检查文本响应、echo 工具调用与工具结果回传。管理员手动触发,最多消耗三次上游请求;每实例最多同时运行三个,同账号最多一个。#86
请求采集与管理界面
- 修复正常流在成功结束后,因连接关闭产生的读取错误被误保留为失败记录的问题;支持识别缺少
Content-Type的 SSE 响应,便于查看上游流式正文。真实失败、提前中断和重试中的失败仍会保留。#82 - 用量明细改为显示「平均 TPS」,按输出 token 数除以请求总耗时计算,避免首字后窗口过短导致数万甚至十万 TPS 的异常显示。该指标包含等待时间,历史记录也按新口径展示。#80
- 「系统设置 → 网关服务 → 使用记录」新增长上下文计费
x2徽标展示开关,默认开启,管理员与用户端同时生效。只影响展示,不改变计费。#85 - 新建质量检测规则时,模型字段默认填入
gpt-6-astra,可直接提交或按需修改。#81
作者压测参考
#91 作者在原分支使用 128 槽与联动预算,通过 BPS 通道测试 gpt-6-astra,报告如下:
| 场景 | 结果 | 延迟 |
|---|---|---|
| 纯文本 100 并发 | 100/100 成功,534 请求/分钟;账号并发峰值 93/100 | 平均 5.9 秒,p95 7.9 秒 |
| 带图 100 并发,663 KB 图片 × 100 | 80 个 HTTP 200、19 个 HTTP 429、1 个客户端连接异常;网关侧无 503 | 平均 16.7 秒 |
作者报告中的 429 来自上游 Rate limit exceeded。附带用量截图显示约 32–38 个输出 token,因此纯文本数据作为短输出场景参考。上述数据来自作者原分支,尚未在最终发版提交上复测,也不代表已验证 512 并发。
升级说明
- 图片中转准入限制覆盖 OpenAI / Composite 的 Responses、Chat 和 Messages HTTP 请求,包括纯文本请求;超过容量返回 503,不在内存中排队。大请求的可用并发受资源预算限制。
- 工具往返探测通过表示所选账号和模型在当次测试中完成了 echo 工具调用,不代表所有工具集或多代理工作流均已验证。
- 请求采集修复仅影响升级后的请求;历史误保留记录不会自动改判,仍按现有保留策略清理,或由管理员删除。
- 本版没有新增数据库迁移。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.14One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.14/deploy/install.sh | sudo bash -s -- install -v v2.8.14Manual download:
Download the appropriate archive for your platform from the assets below.