AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版完善 Excel / BPS 的工具调用、图片传输和代理调度，增加 403 后的账号分组处理，并修复 Pelican 作品预览、Grok 媒体模型选择及 780 打票重试。
Excel / BPS 工具与图片
- 保留工具原始内容：纠正工具封装时保留原始代码和命令，支持客户端明确声明的
FUNCTION_CMD传输，减少exec_command命令在封装转换中被改写的问题。#97、#100 - 工具校验与会话目录：普通 function 参数按声明的 JSON Schema 校验，整批通过后才下发工具；增加有容量和过期限制的会话工具目录缓存。首次返回目录外工具且尚未交付工具时，可进行一次受限纠正。#99
- 可选原生图片上传：后台可选择 BPS 原生附件上传，不再要求公网图片中转地址。先校验完整请求，再通过所选账号及代理上传；启用会话代理时，附件、生成和纠错共用同一出口。原生模式不在本地保存图片文件，仅缓存隔离的附件 ID。#102
- 图片限额可配置：后台可调整请求接入和中转暂存限制；每请求图片数量同时应用于原生上传和 HTTPS 中转，默认 20 张。原生上传仍保留单张 20 MiB、每请求解码后合计 32 MiB 的限制。#107
- 限流状态隔离：BPS 的 429 不再触发 Codex 账号全局冷却或切换账号；回放缓存增加容量、大小和过期约束。BPS 默认压缩阈值提高至 920,000 token。#98、#101
BPS 会话代理与账号管理
- Mihomo 会话出口：账号编辑和批量编辑支持启用 BPS 会话代理，复用内置 Mihomo 节点池。同一健康会话保持节点，不同会话可分配不同节点；节点选择结合业务完成率、连通性和当前负载。动态代理与订阅节点采用不同的评估窗口和故障冷却。
- 故障恢复与诊断：不迁移正在执行的请求；仅在明确尚未发送请求时允许一次换出口重试。全部候选不可用时返回 503，不回退直连。请求采集增加脱敏的传输阶段和流式业务结局，避免仅凭 HTTP 200 判断请求成功。配置与行为说明
- 403 分组处理：可为 BPS 账号配置在指定 403 场景下移入目标分组，或移出所有分组；通过事务检查账号状态与原分组，避免覆盖并发修改。该选项默认关闭，
model_access_changed和附件上传错误不触发该操作。#105
其他修复
- 作品预览：Pelican 缩略图和大图预览按实际作品尺寸适配，改善不同画布比例下的显示。#104
- 780 打票重试：按账号、凭据、网关和协议隔离保存已验证路由，重试时复用；补全 SSE / WebSocket 错误处理，默认目标网关调整为
unified-88。#106 - Grok 媒体模型：配置了聊天模型映射的账号，仍可按媒体资格使用内置图片、编辑和视频模型别名，不扩大普通聊天模型白名单。#95
升级说明
- 图片支持、BPS 会话代理和 403 自动分组均需管理员主动开启；未配置图片传输方式时继续使用 HTTPS 中转。
- 会话代理需要已配置的内置 Mihomo 节点池。节点固定不保证动态代理供应商的公网 IP 固定；进程重启后会话绑定重新建立。
- 提高图片数量时，仍须满足请求体、图片大小和暂存容量的约束；提高请求资源预算会增加内存压力。
- 本版未新增数据库 schema 迁移。原生图片上传及代理池的真实上游表现，仍需在部署环境中验收。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.16One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.16/deploy/install.sh | sudo bash -s -- install -v v2.8.16Manual download:
Download the appropriate archive for your platform from the assets below.