AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版新增内置 BEpusdt 加密货币收款、单 Key 长上下文限制和 AI 运维诊断与受控执行，并为支付确认失败、调度事件积压提供恢复路径。管理员还可配置上游 HTTP 错误率阈值、分组零缓存保护，以及导入导出渠道定价。
收款与订单恢复
- 内置 BEpusdt 收款（#673）：支持余额充值和订阅购买，在「系统设置 → 支付集成」管理钱包、节点与汇率，无需另建支付网关。新实例默认内置模式，币种默认 USDT (BEP20)；需先配置对应公开收款地址、节点和汇率。用户在本站付款页查看地址、精确金额及确认状态。已有外接实例继续沿用原配置。
- 内置引擎支持链上扫描、失败区块重试、漏通知后的主动查单和幂等交付；订单过期后保留 3 小时补扫恢复窗口。转账必须匹配页面指定的币种、网络和精确金额，在线退款尚不支持。来源为 BingBu1/sub2api 的 BEpusdt 集成，保留作者及许可证。
- EasyPay 有界恢复（#680）：查单暂时失败后，系统继续检查原到期时间后 24 小时内的历史订单。只有原提供商实例查到已支付，且订单、商户及金额校验通过，才按原流程幂等入账；不凭回调成功状态直接充值。超窗、原实例不可识别或查单长期不可用的订单仍需人工对账。恢复期内禁止破坏原实例查单身份的配置变更。
Key、分组与账号策略
- 单 Key 长上下文开关（#661）：管理员可在用户的 API Key 设置中关闭「允许长上下文」，已有和新建 Key 默认允许。关闭后，在文本推理转发前按模型阈值估算输入，覆盖 HTTP 和 WebSocket 多轮；缺少完整可见内容的历史、缓存或附件引用会返回
context_unverifiable。此开关不改变计费规则，也不影响其他 Key。 - OpenAI 分组零缓存保护（#671）：默认关闭。开启后，按客户归并 API Key，在已开启保护的分组间观察最近 20 条有效文本请求；集满 20 条且至少 18 条明确为零缓存时，暂停该客户在受保护分组的新请求，默认 5 分钟。媒体、缓存统计未知及不透明历史引用排除出样本；在途请求继续完成。零缓存是保护信号，正常工作负载也可能触发，开启前需评估业务用途。
- 账号 HTTP 错误率阈值（#683）：账号性能弹窗可设置错误率上下限，越界后添加独立调度暂停，未配置时保持原行为。指标只统计当前进程收到的上游 HTTP 响应，重试分别计数；无响应的网络失败、HTTP 200 流内错误和原生 WebSocket 不在其中，多实例不汇总。缺样本不当作 0，单个有效样本即可参与判断，暂停不会随样本消失自动解除。
AI 运维与管理界面
- AI 运维（#664）：新增「智能运维 → AI 运维」，连接独立 Codex SDK 辅助服务查看聚合诊断、建议和历史。控制面默认关闭；显式部署授权、策略授权及解除急停后，才可对受支持的 OpenAI 主 OAuth 账号执行有边界的并发调整、独立暂停和恢复。提供提案冻结、逐项批准、预算、观察、条件回滚及一次性恢复探针；模型和辅助服务不持有生产写密钥。跨实例执行覆盖、真实 SDK 与生产效果仍需隔离验收。
- 菜单与统计（#663、#667）：系统设置可逐项隐藏智能运维侧边栏入口，配置对全站管理员生效，不停用后台功能。利润运维默认查看浏览器本地时区的「今天」，同时保留「最近 24 小时」。
- 渠道定价导入导出（#670）：渠道编辑页支持 JSON 迁移同平台的模型定价，包含阶梯、倍率、图片及视频等计费设置；导入确认后先更新表单，保存渠道才落库。文件不包含渠道绑定、模型映射或账号统计规则；空值与显式零价保持区别。
模型与请求修复
- 调度积压（#681）：单条 outbox 事件处理失败时，先完整保存到 PostgreSQL 补偿队列，再允许主队列继续消费；补偿独立重试，并按最新账号和分组状态发布。持久化失败时仍保留原事件，不以推进水位代替恢复完成。持续数据库或 Redis 故障、大分组锁开销仍需单独处理。
- 模型目录（#682）：新增 GPT Image 2.6 Flare / Sunburst 默认选项、OAuth 图片直连和价卡，清理旧默认选项及订阅目录中的部分失效型号。API Key 路由和显式有效别名保留原兼容路径；新增目录项不代表上游账号已获权限，2.6 新增参数及真实付费生成尚未验收。默认账号测试模型改为
gpt-5.6-sol，未知 GPT 型号的计费兜底继续使用原gpt-5.4目录价，避免探针变化连带改价。 - 上下文错误（#665、#666）：明确的 Responses 上下文超限默认转为 HTTP 400 /
context_length_exceeded，已开始的 SSE 以对应错误事件结束；运维分类保留真实上游状态，避免把包装成 502 的输入限制计入上游故障，不改变实际上下文容量。 - 接入与界面（#660、#674、#685）：新生成的 OpenAI Codex 快速配置与配置文件默认带
service_tier = "fast"，不会改写已有客户端文件，CC Switch 是否保留该字段取决于其版本支持。修正多授权连接文档的 OAuth 母账号限制；点掉「新功能」标签后释放页签空间，避免标签遮住页签点击。
升级注意
- 相对 v2.19.5 新增三份数据库迁移：
333_ai_ops_control_plane.sql、333_api_key_allow_long_context.sql、334_scheduler_outbox_retries.sql。升级前备份 PostgreSQL；API Key 鉴权缓存和区域快照升级至 v33，区域部署需发布匹配快照。 - 内置收款必须持久化并备份
${DATA_DIR}/bepusdt/整个目录，与主数据库配套恢复。每个引擎目录由单进程独占；多副本部署应使用集中外接网关，不让多份独立引擎库共用收款钱包。BEpusdt 按 GPL-3.0 分发，第三方声明和对应源码随版本保留。 - **API Key 独立槽位 TTL（#669、#672）**新增
gateway.api_key_slot_ttl_seconds，默认0继承原 TTL，仅升级不缩短租约。显式值至少 30 秒；首次启用、修改或回滚有效 TTL 时，共享 Redis 槽位命名空间的实例必须统一排流后切换，禁止不同有效 TTL 混跑，也不能清 Redis 代替排流。account/user 槽位、Live 租约和区域并发授权沿用原期限。 - 回滚需处理新增状态：旧二进制不消费 outbox 补偿表，回滚前需排空并确认
pending=0，无法排空时按文档安全回灌，不能只看主 watermark；AI 暂停、长上下文限制也不能依靠回退旧二进制维持保护。 - 新收款网络需完成小额实际付款与重复查单验收；AI 控制、分组保护和性能阈值按需显式启用。发布产物与 CI 验证不代表已完成生产部署或真实资金、模型请求验收。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.19.6One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.19.6/deploy/install.sh | sudo bash -s -- install -v v2.19.6Manual 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.19.6/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.19.6Defaults: namespace tosky-canary, Deployment tosky-nerd; override with --namespace NAME --deployment NAME.
Upgrade every instance sharing Redis to this release.