Skip to content

Sub2API 2.8.14

Choose a tag to compare

@github-actions github-actions released this 25 Sep 20:00
· 441 commits to production since this release

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

本版重点改善 Excel / BPS 的并发准入、代码工具调用和限流处理,新增账号工具往返探测,并修复请求采集与用量展示问题。

Excel / BPS

  • 图片中转容量可配置:在「系统设置 → 功能开关 → Excel / BPS 图片中转」中调整请求体上限、共享资源预算和最大在途请求数,保存后对新请求生效。未知长度与压缩请求按读取后的实际正文大小保留预算,减少小请求因预留过大而触发的 basispoints_image_request_busy 503。#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.14

One-line install (Linux):

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

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation