Releases: ranxi2001/sub2api
Release list
Sub2API 2.8.11
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版修复 Excel / Basispoints 接入在 Codex 工具结果续传和上游报错时的兼容问题，并让已启用 BPS 的 OpenAI OAuth 账号测试走实际的 BPS 请求路径。
Excel / Basispoints 修复
- 将不符合 BPS 要求的 Codex 工具结果 item ID 转成稳定的
fc_...ID，保留有效 ID、call_id和结果内容，避免续传请求因Expected an ID that begins with 'fc'被上游拒绝。 - BPS 已写出 JSON 错误或流式终止事件时，不再由网关追加第二个错误事件；compact 心跳已提交 SSE 响应头时继续写流内失败事件，避免响应格式混杂。
- 账号测试对已启用 BPS 的 OpenAI OAuth 账号使用 BPS 请求格式和端点。未启用 BPS 的账号仍按原有路径测试。
- Ops 保留上游状态码和请求 ID。默认不记录可能回显请求内容的上游错误消息；启用现有上游错误体记录开关后，仅提取并脱敏有限的错误字段，详情仍受配置的大小上限约束。客户端响应不包含上游原始错误体。
升级说明
- 无新增数据库迁移。Excel / Basispoints 仍需在 OpenAI OAuth 账号上显式启用。
- 本版不改变上游模型权限，也不会因 BPS 错误自动重放请求或切换账号。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.11One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.11/deploy/install.sh | sudo bash -s -- install -v v2.8.11Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.10
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版在现有 Excel / Basispoints 协议接入上补强 Codex 工具调用恢复、子线程隔离和图片请求边界，继续保留 OpenAI OAuth 账号的可选协议切换。
Excel / Basispoints 工具调用修复
- 模型直接调用已声明的客户端工具时，即使没有包在
run_officejs中，也会按声明安全恢复为客户端工具调用；未知工具、类型不匹配工具和原生托管工具仍拒绝执行。 - 保留完整原生工具 item、
call_id、参数、namespace、custom 原始文本及回放历史；工具结果必须匹配原始调用，缓存缺失时要求新建会话。 - 修复 custom transport、重复 JSON 包装、历史恢复和 Codex continuation；文本响应继续流式输出，工具调用等完整终态验证后再回放。
- 回放缓存按账号、API Key 和 Codex thread 隔离。多个子线程可以并发请求，避免共用父
session_id时串用工具历史；单个 BPS 响应仍按一个 transport 工具调用处理，不宣称并行工具或子代理能力等同原生 Codex。 - Excel/BPS 开关仍只对 OpenAI OAuth 账号显示，关闭后恢复原 Codex 路径；使用账号已有 ChatGPT OAuth 凭据，不需要 GitHub Copilot sidecar。
- 这批修复吸收了
hloolx/codex2api后续的 direct-call recovery、custom transport、history recovery 和 WS continuation 改进，并保留来源说明与本项目账号隔离逻辑。
图片与请求边界
- BPS 仅接受上游可访问的 HTTPS 图片 URL；base64、file ID 和本地文件路径明确拒绝，不会替用户上传图片。
max/ultra等 reasoning effort 按 BPS 支持的实际档位处理；模型权限和上游行为保持原样，不自动切换模型。- BPS 继续使用独立 HTTP/SSE 长流链路和取消处理。错误响应不触发无依据的账号切换或有副作用重放。
升级说明
- 本版无新增数据库迁移。
- 已开启 Excel/BPS 的 OpenAI OAuth 账号，升级后需新建 Codex 会话；工具历史缓存缺失时按错误提示重新开始。
- 子代理并发仍受账号并发数、调度和 BPS 上游能力约束。已运行协议包、线程隔离、service 和前端开关回归；真实多代理长任务仍需部署者验收。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.10One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.10/deploy/install.sh | sudo bash -s -- install -v v2.8.10Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.9
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版新增 Copilot SDK 的 Codex 接入模式，补充账号异常通知与质量检测工作台，支持向用户展示选定分组的鹈鹕测智结果，并修复 780 原生采票的路由与诊断问题。
Copilot SDK 接入 Codex
账号怎么配置：v2.8.9 没有后台 GitHub 登录或账号导入按钮。 管理员需要先在服务器部署独立适配服务（sidecar），运行 login.py，在浏览器完成 GitHub 设备码授权。仅勾选后台开关不会完成登录。
- 管理员登录 GitHub：按公开教程安装配套脚本、执行设备登录并启动 sidecar；GitHub Token 自动保存在服务器，不填入 Sub2API 后台。
- 后台添加上游账号：进入“账号管理 → 添加账号”，平台选 OpenAI、类型选 API Key，勾选 Copilot SDK。同主机二进制部署的 Base URL 填
http://127.0.0.1:18765/v1，API Key 填 sidecar 生成的sidecar-key，绑定仅含此账号的独立分组。 - 使用者配置 Codex：在站点 API Key 页面创建绑定该分组的 Sub2API Key；Codex 使用站点
/v1地址、wire_api = "responses"和管理员提供的真实模型名。普通用户不需要 GitHub Token 或 sidecar Key。
公开安装教程：GitHub 登录、后台字段、三个 Key 与 Codex 配置 · 公开配套脚本
- 本次公开补充的脚本兼容 v2.8.9 账号模式，但不在原 v2.8.9 安装包或 tag 中；须从上方公开路径另行获取，无需访问运维私库。Docker 的 loopback 与宿主机不同，网络设置见教程。
- 保留 Codex 原生工具调用与会话字段，工具仍由 Codex 执行；客户端取消传到 sidecar，错误回合不自动切换账号重放。
- 首版默认关闭，要求独立分组、单个 sidecar 账号和单进程；不支持后台一键 OAuth、多账号批量导入、pending 工具回合重启恢复或完整视觉任务。错误实例/丢失回合返回 409，需新开会话。
- 适配器基于 Nonary/ghcp_proxy 固定版本。已完成本地协议测试与构建；完整 Sub2API → sidecar → GitHub 链路仍需部署者按自己的账号验收。
账号运维与质量检测工作台
- 新增账号运维入口，可配置余额不足、周配额异常的邮件通知。通知默认关闭，需配置收件地址、通知类型与邮件服务后启用。
- 同一账号、同一异常类型合并记录，并按冷却时间发送；网关请求不等待邮件发送，事件不保存原始上游响应或凭据。
- 调整账号质量检测工作台，集中展示规则、运行状态和检测结果，保留既有定时检测与隔离恢复行为。
实现见 PR #55。
用户侧鹈鹕测智展示
- 管理员可在系统设置中开启展示页，选择展示分组，并设置每组保留数量与自动清理天数。
- 展示数据独立保存为快照，管理员测试历史清理后仍可按展示策略保留；未选择分组时不会产生展示内容。
- 展示具体题目的生成结果，方便用户查看与比较，不代表模型整体能力认证。
感谢 akihitohyh 在 PR #54 中贡献该功能。
780 原生采票修复
- 统一目标 gateway 名称的解析，补充
any目标处理与实际 gateway 记录，减少不同输入形式导致的路由判断差异。 - 修复托管 Mihomo 采票链路的配置与节点处理，补充手动采票、边缘 IP 和并行采票的验证。
- 将传输错误、模型声明不匹配、Cookie 缺失、过期及 gateway 不匹配分别归类，管理界面提供更具体的失败原因，同时避免把含凭据的原始错误写入日志。
实现见 PR #56。780 仍指票据格式长度，路由与模型声明验收不构成模型能力或回答质量保证。
升级说明
- 相比 v2.8.8，新增
249_account_ops_alerts.sql与249_pelican_showcase_items.sql两个迁移，分别保存账号通知状态和展示快照。升级前备份数据库，按实际迁移结果评估回滚。 - Copilot SDK 的 GitHub Token、sidecar Key 与 Sub2API 客户端 Key 用途不同，应按运维说明分别配置；不要将 Copilot sidecar 与普通 OpenAI 账号混池。
- 既有 292/780 兼容与 DeepSeek 压缩路径继续保留。本次发布不自动修改生产开关或重启生产服务。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.9One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.9/deploy/install.sh | sudo bash -s -- install -v v2.8.9Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.8
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版在现有打票流程中加入 780 原生采票、WebSocket 取票和指定边缘 IP 直拨；同时新增账号质量定时检测与隔离恢复，补充分组模型限制、仅流式请求和指定用户公告，方便分别控制账号可提供的模型、用户可调用的模型及异常账号的处理方式。
780 原生采票与边缘 IP
- 入口：管理后台“打票全流程”（
/admin/harvest-flow）。沿用既有采票代理、后台轮询、手动采票和账号缓存，新增采票协议、边缘 IP 与目标网关设置，并展示对应票据摘要。 - 支持 SSE 与 WebSocket。SSE 校验完整
response.created中的响应 ID 和模型声明；WebSocket 从codex.response.metadata读取票据。采票协议与业务上游协议分别检查，避免跨协议注入。 - 可指定公网边缘 IP 作为连接目标，HTTP Host、TLS SNI 和证书校验仍使用
chatgpt.com。管理员手动采票接口支持通过X-Edge-IP覆盖本次拨号地址；留空时使用 DNS。 - 780 票龄从签发时刻计算，最多 240 秒；路由 Cookie 独立按 JWT exp 检查有效期。仅保留完整的
__cflb/__oailbpair，拒绝目标网关不符、部分轮换或删除后的无效组合。 - 边缘 IP 与 Cookie 声明的 gateway 是不同层级，固定边缘 IP 不保证命中指定 gateway。780 仅表示票据格式长度，模型声明和路由验收不代表能力保证；真实账号对照仍出现携票回答错误，历史通过的 host 也尚未接入自动候选选择。
账号质量定时检测与隔离恢复
- 新增“降智运维”页面，按账号配置测试题目、预期答案、测试模型、推理强度、五段 Cron 和每轮测试次数。任务由服务端执行，关闭页面后仍会运行；每个账号只配置一条质量规则。
- 支持选择判题分组、判题模型及提示词。判题从指定分组选择可用账号，并跳过被测账号；只有明确判错才执行失败动作，判题请求失败或结论不明确时不修改账号。
- 答错后可移出指定分组，或关闭账号调度并保留分组。可选在后续整轮测试全部通过时自动恢复，只恢复本规则实际移除的分组或关闭的调度；遇到其他操作修改账号或分组关系时停止自动恢复并记录冲突。
- “运营记录”按轮次汇总处理状态与通过次数，可查看回答原文和判题理由。检测记录展示最近 100 次测试，最多保留 7 天；补充内置糖果题的答案校验。
- 删除规则不会自动恢复已移除的分组或关闭的调度，需要先在账号页处理。
功能与处理边界见 PR #51。
分组模型限制与指定用户公告
- 账号可按分组设置可用模型清单，范围仍受账号自身支持的模型限制；未配置时沿用原有行为。
- 分组可为单个用户配置禁用模型，与该用户的专属倍率和 RPM 配置共用管理入口。
- 分组新增“仅允许流式请求”开关，默认关闭。开启后，Messages、Chat Completions、Responses 的非流式生成请求，以及 Gemini
generateContent请求会在网关入口被拒绝。 - 公告新增“指定用户”展示方式，可在公告编辑时选择接收用户。
感谢 akihitohyh 在 PR #43、PR #45、PR #48 和 PR #50 中贡献上述功能。
界面修复
- 修复在弹窗内拖选文字、松手落在遮罩上时误关弹窗的问题。
- 请求耗时详情抽屉支持点击左侧空白区域关闭。
升级说明
- 相比 v2.8.7，新增 244–248 数据库迁移，涉及分组模型限制、仅流式开关、账号质量状态及评分记录；升级前备份数据库。780 采票本身未新增数据库迁移。
- 采票默认关闭，既有开关按已保存配置生效。新配置默认票长 780、TTL 240 秒、提前 60 秒刷新；已有配置若显式保留 292，需修改
gateway.openai_codex_ticket.target_length后重启，旧格式兼容路径继续保留。 - 采票协议应匹配业务实际使用的上游协议；WebSocket 入站若通过 HTTP bridge 转发，仍应选择 SSE 采票。
- 定时质量检测与模型判题都会产生实际模型调用，请按需要设置周期和每轮测试次数。检测结果只反映所用题目及判题配置，不代表模型整体能力。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.8One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.8/deploy/install.sh | sudo bash -s -- install -v v2.8.8Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.7
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版为“鹈鹕测智”加入服务端定时测试和全屏记录卡片：按 Cron 持续生成同题 HTML，在一个页面查看多账号、多次测试的动画、来源、模型与耗时。同时包含 Cyber 会话身份识别修复，减少共享缓存键或冲突身份造成的会话误拦。
鹈鹕定时测试与记录卡片
- 入口：账号管理 → 账号“更多” → 鹈鹕测智。默认题目为 SVG 鹈鹕骑自行车动画，模型
gpt-6-astra、中等思考强度、1 路生成，支持按账号实际能力修改。 - “定时测试”复用现有计划管理，支持标准 5 字段 Cron、启用/暂停、编辑、删除及可选自动恢复。默认 Cron 为
*/30 * * * *，服务端执行，关闭网页后仍会运行；不会自动创建计划。 - 点击“测试记录”打开全屏卡片页面。每次输出一张卡，同账号的多次测试、不同账号的测试及失败记录都会显示，不受账号表格分页或筛选影响。
- 卡片展示手动/定时来源、生成时间、模型、思考强度和耗时；点击卡片或动画区域可放大查看。页面每 15 秒刷新，记录较多时可继续加载，HTML 正文按可见卡片读取。
- 手动记录与服务端定时记录合并展示，空账号不生成卡片。手动结果仍保存在当前浏览器，换设备或清理浏览器数据后不会同步恢复；旧记录未采集的时间或耗时显示“—”。
- 保留人工比较方式，不自动评分。模型输出使用隔离 iframe 与 CSP 展示。
运行与存储控制
- 每个计划每轮支持 1–8 份并行输出。同账号的多个定时计划通过数据库锁和租约避免同时启动；暂停后不再开始新一轮，已开始的一轮会继续完成。
- 每个定时计划默认保留最近 100 份结果，可配置 1–200 份；超过 7 天的结果自动清理，暂停后仍会清理。单份保存正文最多 2 MiB，超限记录失败原因，不保存正文。
- 生成失败会保留失败记录；流未正常完成时不标记成功。结果保存当次配置，之后修改计划不会改写历史记录的模型与思考强度。
Cyber 会话身份识别
- 会话屏蔽按 API Key、明确的 thread/session 身份及身份类型隔离；
prompt_cache_key、来源 IP、User-Agent 和历史相似度不再作为跨请求封锁身份。 - HTTP 与 WebSocket 使用一致的身份解析规则；冲突或非法身份不建立跨请求封锁。WebSocket 后续轮次可继承连接已确认的身份，显式切换身份时要求重连。
- 新增可选的严格身份门控，默认关闭，且只在 Cyber 会话屏蔽开启时生效。开启前应确认客户端稳定传递明确的会话 ID。
感谢 blackdm666 在 PR #39 中贡献会话身份修复。行为和升级边界见 Cyber 会话屏蔽说明。
升级说明
- 新增
243_pelican_scheduled_tests.sql，为定时计划和结果增加可空的鹈鹕配置及执行租约字段；升级前备份数据库。 - 如果回滚到不支持鹈鹕计划的旧版本，先暂停鹈鹕计划，避免旧调度器将其按普通连接测试处理。仅替换旧二进制不会删除新字段。
- 既有普通连接测试入口和计划继续保留。定时生成会产生实际模型调用，请按需要设置周期和并行数。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.7One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.7/deploy/install.sh | sudo bash -s -- install -v v2.8.7Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.6
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版新增请求耗时详情与 TPS 展示，帮助区分请求接收、本地处理、排队和上游等待；同时按提交同步上游 v0.2.8，加入 OpenCode Go 用量查询、推理力度计费倍率和备份管理等功能，保留 fork 的门票、代理控制、DeepSeek compaction/SSE 与鹈鹕测智。
请求耗时详情与 TPS
- 管理员点击使用记录的延迟列，可打开右侧详情抽屉，查看完整请求耗时、请求体读取、鉴权审核、并发等待、账号选择、上游连接与响应等分段。HTTP Responses 路径启用详细采集，历史记录无法补采集；详情保留 30 天。
- 首个语义事件、首个可见输出和应用侧首次输出 Flush 分别记录。原列表首字/总耗时保持原计时口径，详情补充完整请求耗时，避免遗漏转发前的等待。
- 增加分级颜色、文字标签、首字解读及最长已采集本地阶段提示。颜色是排查参考，阶段可能重叠，不能直接相加；应用侧读取速率和 Flush 也不代表客户端公网带宽或实际接收时间。
- 上游出口与实际 HTTP 尝试分层编号，保留每次尝试的数据。正常完成后关闭上游流不再误报“已取消”；HTTP 状态与传输结束原因分开展示，旧记录保留原信息并说明局限。
- 管理员和用户使用记录增加 TPS 与三段健康色条。TPS 按输出 Token 和耗时估算，推理 Token、缓冲及极短输出窗口可能使结果偏高，不等同于模型实际生成速度。
感谢 akihitohyh 在 PR #35 中贡献 TPS 展示。详情采集与解释见 PR #36、PR #37。
同步上游 v0.2.8
本次通过 PR #38 按上游顺序 cherry-pick 67 个提交，跳过已引入补丁，并保留 fork 独立版本号和定制行为。
- OpenCode Go 支持官方用量窗口查询、主动刷新与自动刷新，以及同 Key 用量共享和刷新防抖。
- 支持自动同步 Claude Code 客户端版本号，并避免无效 User-Agent 覆盖已有版本设置。
- 支持按推理力度配置计费倍率；未配置的力度使用 1 倍，并修正部分转发路径的最终推理力度记录。
- 增加 Codex 积分展示与邀请管理、月度备份归档及独立保留策略、滚动日志保留设置。
- 简易模式可选启用 API Key 消费窗口限额；管理员登记线下提现支持幂等，避免同次登记重试重复扣减。
- 同步工具 schema、图片路由、流式错误与前端交互修复。Gemini/Banana 图片模型保留兼容 API Key 通道，插件账号快照继续剔除门票私有字段。
升级说明
- 相比 v2.8.5，新增请求耗时详情表、推理力度倍率和提现幂等三项迁移。升级前备份数据库。
- 倍率迁移会将已配置的旧
max_reasoning_effort_multiplier转换为通用倍率映射，分组 JSON 中已消费的旧键会移除。升级后检查自定义计费规则；仅回滚二进制不能保证恢复旧版倍率语义。 - 详情采集不保存请求正文、凭据或代理 URL。详细诊断仅管理员可查；不将 HTTP 200 单独视为流完整的证明。
- 已有门票、业务代理和采票代理配置保持原有用途；本次发布不会自动开启这些功能。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.6One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.6/deploy/install.sh | sudo bash -s -- install -v v2.8.6Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.5
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版新增“鹈鹕测智”：在指定账号上用同一道 SVG 动画题生成 HTML，直接预览、下载并人工比较结果。同时修复 Cyber 会话身份识别，并扩展 OpenAI 图片接口的模型名称兼容。
鹈鹕测智
- 入口：账号管理 → 单个账号“更多” → 鹈鹕测智。原有“测试连接”入口和行为保留。
- 默认题目为“鹈鹕骑自行车的 SVG 2D 动画”，默认模型
gpt-6-astra、中等思考强度、1 路生成，可修改题目与模型，最多同账号并行生成 8 份。 - 统一要求返回无外部依赖的独立 HTML，结果支持页面预览和 HTML 下载；浏览器本地保留最近 8 次测试记录。
- 不自动评分。通过生成结果人工观察表现差异，不能据此确认真实模型路由或断定模型降级；模型可用性仍取决于账号权限。
会话身份与图片接口兼容
- Cyber 会话识别支持请求体
client_metadata.thread_id/session_id，并统一 HTTP、流式 HTTP 和 WebSocket 包装请求的解析规则。身份冲突时不建立跨请求封锁键，避免影响其他会话；保留 Claude Code 的用量会话标识。 - OpenAI 图片接口的模型校验允许
banana*和包含image的gemini-*名称，方便接入支持这些模型的兼容上游。此项放行名称校验，不代表所有上游都具备对应生图能力。 - 无新增数据库迁移。
来源：鹈鹕测智 #33、会话身份 #32、图片接口 #31。感谢 blackdm666 和 buluw 的贡献。
📥 Installation
Docker:
docker pull ghcr.io/ranxi2001/sub2api:2.8.5One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.5/deploy/install.sh | sudo bash -s -- install -v v2.8.5Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.4
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版将 GPT-6 Sol、GPT-6 Luna 和 Claude Opus 5.5 纳入 owner fork 的模型目录、请求兼容和计费路径。需要使用这些模型的部署可以在保留原有账号映射的同时，为客户端提供明确的模型名称；实际可用性仍取决于上游账号的模型权限。
GPT-6 Sol/Luna
- 新增
gpt-6-sol和gpt-6-luna模型目录项，支持模型列表、账号模型映射和 Codex 请求模型规范化。 - 保留模型名称及已有 effort/compact 后缀，避免客户端请求在网关转发时被错误降级到其他模型。
- 补充 OpenAI Responses、Chat Completions 及 Anthropic 兼容转换路径的模型元数据和测试覆盖。
Claude Opus 5.5 与模型兼容
- 增加 Claude Opus 5.5 的模型目录、努力级别和兼容转换支持。
- 扩展跨协议请求/响应转换、模型别名处理和模型列表合并逻辑，保持已配置的账号级映射行为。
计费与使用边界
- 增加 GPT-6 Sol、GPT-6 Luna 和 Claude Opus 5.5 的价格与上下文窗口数据，计费沿用现有模型和分组倍率规则。
- 模型已被网关识别不等于上游账号自动获得访问权限；OAuth/API Key 账号仍需拥有对应模型权限，模型映射也必须指向账号实际可用的上游模型。
- 本版本不自动开启 Codex ticket 采集，不改变业务代理或账号调度策略。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.4One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.4/deploy/install.sh | sudo bash -s -- install -v v2.8.4Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.3
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版为账号计费增加独立的“分组计费倍率”。需要让 API Key 账号加入优惠分组、同时按指定价格向用户计费的部署，可以在账号级别覆盖分组倍率，而不改变原有账号成本统计口径。
账号分组计费倍率
- 所有账号新增“分组计费倍率”，默认
1x，可在账号创建、编辑和批量编辑中单独调整。 - 用户/API Key 实际扣费倍率为：分组生效倍率 × 账号分组计费倍率。
- 例如分组倍率为
0.2x，账号分组计费倍率设为5x，最终用户扣费恢复为1x。 - 原有“账号计费倍率”保持原语义，只影响账号成本统计，不参与用户/API Key 扣费。
- 管理员导入导出、批量创建和账号列表返回均保留该字段，便于迁移和批量维护。
兼容与边界
- 新增数据库迁移
241_add_account_group_rate_multiplier.sql；旧账号升级后默认按1x运行。 - 负数倍率会被拒绝；
0x可用于将该账号的用户扣费设为零。 - 账号级倍率与用户在分组上的个性化倍率分别参与计费解析，不能将账号成本倍率当作用户扣费倍率使用。
- 本版本基于 owner fork 的
production，PR #26 及其他未合并功能不在本次范围内。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.3One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.3/deploy/install.sh | sudo bash -s -- install -v v2.8.3Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 2.8.2
AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版聚焦 Codex 292 打票出口和内容审计配置：动态代理可作为 Mihomo 打票节点轮换，订阅下载在当前出口失败时可直连备用；内容审计新增 TypeSafe AI 独立引擎配置，升级后默认仍使用 OpenAI。
动态代理打票与订阅下载
-
Mihomo 打票代理支持多行动态代理输入，支持 HTTP、HTTPS、SOCKS5 和 SOCKS5H。
-
支持以下常见格式：
hostname:port:username:password username:password:hostname:port username:password@hostname:port hostname:port@username:password -
每条代理生成独立节点并加入
CODEX-ROTATE轮换组；不会自动生成新 SID，也不保证不同 SID 对应不同公网 IP。 -
动态出口可能在每次连接时更换 IP。地区筛选提供独立的“供应商控制地区”选项；启用后由供应商负责地区约束，服务端不会把历史 IP 检测结果当作当前连接的地区证明。
-
机场订阅与动态节点可以同时保存。订阅经当前打票出口下载失败时，系统会尝试服务器直连；两条路径均失败时保留上一份可用配置。
内容审计双引擎
- 新增 TypeSafe AI（Jev）原生审计引擎，与 OpenAI 分别保存地址、模型、密钥、代理、超时、重试和阈值配置。
- 升级后默认仍为 OpenAI；启用 TypeSafe 前请先确认数据处理要求，并使用观察模式校准阈值。
- 审计记录增加可空引擎元数据，历史记录保持兼容；图片输入在 TypeSafe 引擎中跳过并记录数量。
- TypeSafe 的 13 类评分与 OpenAI 评分含义不等价，本版本不承诺准确率或自动处置效果。
- 此功能引入自上游 PR #7387。
上游同步与修复
本版整合 2026-09-22 上游已合并的 60 个 PR（66 个实际提交），同时保留 fork 的独立版本及自有采票实现。
- 流式响应在完整终止事件后及时结束，修复响应体关闭卡住；心跳不再误计为模型输出，Anthropic ping 不再混入 OpenAI 转换结果。
- 工具调用完成事件补齐 arguments；修复 GPT-5.5 映射后的 Lite 标记、过长输入条目 ID 和非 ASCII turn metadata。
- 修复非高级调度的 previous_response 路由、调度缓存 RPM 字段及选号期间不必要的分组账号统计。
- 增加 Grok 4.7 支持，允许冷却期间查询 Grok 配额；改进 Gemini 传输失败切换、Vertex 429 冷却和 Antigravity schema 兼容。
- 修复代理续期与过期扫描竞争、失效备用代理选择及代理恢复后的探测缓存；修复负向订阅兑换的并发锁和不足整天的扣减。
- 简易模式可关闭启动时默认分组创建；修复 OAuth 重新授权设置保留、生图余额错误，以及管理界面过期请求、弹窗滚动锁、选择框键盘操作和图片读取顺序等问题。
升级提示
- 包含数据库迁移
238b_content_moderation_engine_meta.sql，升级前请备份数据库。 - 本版本不自动开启 TypeSafe，也不改变现有内容审计处置策略；TypeSafe 未在本版本中调用真实付费接口。
- 启用动态代理地区由供应商控制后，
region-Random之类配置不能保证排除 CN/HK；需要在供应商侧指定地区。 - 292 打票仍受上游票据形态、账号状态、代理质量和 Cookie/session 有效性影响。
x-codex-turn-state等协议字段和票据长度不构成模型能力或长期稳定性保证。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.2One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.2/deploy/install.sh | sudo bash -s -- install -v v2.8.2Manual download:
Download the appropriate archive for your platform from the assets below.