Skip to content

Sub2API 2.9.7

Choose a tag to compare

@github-actions github-actions released this 02 Oct 15:54
· 3430 commits to production since this release

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

本版同步官方 v0.2.10 至 v0.2.13 的精选更新,包括 Claude Sonnet 5.5、GPT-6.1 Sol、TypeSafe 平台、充值优惠阶梯和三项安全加固。同时新增 API Key 独立并发限制,补齐 Key 删除后的 WebSocket 撤销检查与结算;鹈鹕测智支持凭 API Key 读取作品;默认关闭的 Prism 试验通道新增并发执行和客户端工具桥。包含 3 个数据库迁移,升级前已发出、尚未使用的重置密码链接会失效。

官方同步

  • 官方 v0.2.10:支持 Claude Sonnet 5.5(含定价);修正流式请求的用量统计;组合分组的 Responses WebSocket 按组合路由解析别名,连接内切换公开模型名需要重新建连;编辑账号时阻止白名单与模型映射冲突;仪表盘最近用量可在 token 与花费之间切换。#275
  • 官方 v0.2.11 精选:新增 GPT-6.1 Sol 的别名、目录、协议转换、effort 校验和默认价格;Codex 配置默认使用远程目录(面向 Codex 0.156.0+,旧客户端可改用本地文件);同步 ChatGPT 套餐名称和徽标;Astra Ultrafast 改按标准 token 价格 6 倍计费;claude_code_only 分组配置降级组后,Chat / Responses 兼容入口进入降级调度。#253
  • 官方 v0.2.12–v0.2.13 精选:新增 TypeSafe / Jev System One 平台(POST /v1/systemone,模型 jev-latest);后台支付设置新增充值优惠阶梯,支持赠金或折扣,默认关闭;账号列表可直接加减或输入优先级;用户 API Key 列表可按分组排序。#277
  • Grok CLI 身份:固定版本从 0.2.120 升到 1.0.44,修复上游以 HTTP 426 拒绝请求的问题 #258;随后对齐官方交互式 CLI 1.0.46 的 UA、客户端标识和模式请求头 #277。XAI_GROK_CLI_VERSION 低于 1.0.46 时回退到默认值。
  • 未同步官方的在途余额预占、Claude 原生额度查询 / 兑换和官方安全策略文档。

API Key 与安全

  • API Key 独立并发限制:每个 Key 可设置 concurrency_limit,默认 0 表示不额外限制;受限 Key 默认最多 5 个请求排队、等待 30 秒,覆盖 HTTP、SSE、WebSocket 和 Live。Key 管理支持单独或批量修改,并显示活动数和等待数。#263
  • 每用户 Key 数量与创建频率:默认最多 200 个未删除的 Key、每小时创建 60 次,0 表示不限;禁用或过期但未删除的 Key 也计入数量。#253
  • 官方安全加固:匿名订单查询 POST /api/v1/payment/public/orders/verify 按客户端 IP 每分钟最多 20 次;邮箱验证码的失败次数改为原子计数;重置密码令牌只保存哈希,且只能使用一次;Antigravity 的 Gemini 路径返回给客户端的上游错误改为脱敏格式。#277
  • Key 删除后的处理:Responses WebSocket 在首轮选号后和每个后续轮次,直接从数据库复核 Key 状态;Key 被删除、禁用或替换后,新轮次在到达上游前被拒绝(来自 #273)。请求进行中 Key 被删除时,用户余额和订阅照常结算,这把 Key 自身的额度和限速计数跳过(官方 Wei-Shaw#7816 做法)。#277
  • 风控白名单:管理员可以把可信用户(如下游中转站)加入名单。名单内用户命中上游 cyber_policy 或本地内容审核时只记录,不封号、不本地屏蔽;上游拦截照常返回。#275

鹈鹕测智

  • 凭 API Key 读取作品:新增 GET/HEAD /api/v1/public/pelican-showcase 清单和按 ID 读取正文的接口,只读、不调用模型、不扣费,支持 ETag / 304 和 gzip #268。管理端新增「允许 API Key 读取作品」开关(默认开启),用户端新增「API 调用」说明弹窗 #272。
  • Claude 账号测试:鹈鹕 / 智商测试发给 Claude 的请求改用 max_tokens: 32000 并传递思考强度;回答被截断或被拒绝时说明原因,不再只显示「模型返回为空」。Anthropic 账号的默认测试模型改为 claude-opus-5-5。#271
  • HTTP 面板预览:用 http://IP:端口 打开面板时,鹈鹕作品预览不再空白。#262

Prism 试验通道(默认关闭)

  • 为 OpenAI OAuth 账号增加 Prism 开关和纯文本适配,由本机浏览器适配服务完成登录和项目流程 #260;同一会话自动复用浏览器上下文和项目 #267;新增并发执行模式,全局和单账号默认上限 20,支持 gpt-6.1-sol、gpt-5.6-sol、gpt-5.6-terra、gpt-6-luna 和 low / medium / high / xhigh 思考强度 #269。
  • gpt-6.1-sol 支持客户端工具桥(function / custom / namespace),工具仍由客户端在自己的权限下执行。需要服务端设置 PRISM_ADAPTER_CLIENT_TOOLS_ENABLED=true,并同时升级 Go 网关和适配器。#278
  • 目前仍是不计费(usage 为空)的试验通道,不建议作为普通用户的生产通道。实测报告见 docs/PRISM_BRIDGE_RESEARCH_CN.md。#265

BPS 与账号运维

  • BPS 图片默认原生上传:图片传输方式默认改为「BPS 原生附件上传」,新建和未设置的配置默认开启图片支持;移除「图片支持关闭时忽略图片输入」开关。已显式保存的 HTTPS 中转和关闭设置继续有效。#242
  • BPS 默认模板:新增「HTTP 流式 WS 加速」和「降智后自动开启 BPS」两个勾选项,默认关闭。本版只保存模板字段,账号的「使用默认配置」暂未使用这两项。#249
  • 凭证运营:重登引擎和本地 Worker 数量(1–16)移到「凭据加密」区域统一设置,即时保存;账号列表新增「自动巡检」「自动重登」即时开关。新版 Worker 约每 5 秒同步进程数量,需要配套升级 Worker。#248
  • 账号测试经 WebSocket 发送:没有 API Key 的后台账号测试经 Responses WebSocket v2 发送时,不再被分组准入误拒为 group_membership_changed。修复后这类测试会真正请求上游并消耗额度。#259

管理与部署

  • 功能搜索:管理端新增功能搜索入口(Ctrl / ⌘ K),可直接打开页面或定位到系统设置中的具体卡片。#250
  • Serverless 地区分流:「设置 → 网关服务」新增默认关闭的 Serverless 管理面板,可按地区把新绑定的 API Key 分流到管理员确认过的 Pod。主站与 Pod 需要共享至少 32 字节的集群密钥;开启后,首次查询会把客户端公网 IP 发送给 GeoJS。#251
  • k3s 副机升级脚本:新增 deploy/upgrade-k3s.sh,指定正式版本即可更新单节点单副本的 Deployment;Release 说明会自动附带对应版本的升级命令。#247
  • 不带 /v1 的 API 路径:启用嵌入式前端时,/chat/completions、/models/*、/embeddings 等路径不再被前端页面兜底、返回 HTML。#245

升级与回退

  • 包含 3 个迁移:237_add_api_key_concurrency_limit.sql(Key 并发限制列,默认 0)、241_add_payment_order_bonus_amount.sql(订单赠送额度列,默认 0)、241_add_typesafe_platform.sql(配额与组合路由的平台约束加入 typesafe)。编号低于已有迁移,执行器按文件名补跑;回退二进制不会撤销迁移。
  • 升级前已发出、尚未使用的重置密码链接会失效,用户需要重新申请;注册和通知邮箱验证码不受影响。
  • Prism 工具桥和凭证运营 Worker 数量同步,需要同时升级对应的适配器或 Worker。
  • 回退旧版本前,先停用 TypeSafe 账号和分组、关闭充值优惠阶梯;旧版本不支持 typesafe 平台,也不读取订单赠送额度。
  • 发布产物与生产部署是独立步骤。

完整版本对比


📥 Installation

Docker:

# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.9.7

One-line install (Linux):

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

Manual 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.9.7/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.9.7

Defaults: namespace tosky-canary, Deployment tosky-nerd; override with --namespace NAME --deployment NAME.
Upgrade every instance sharing Redis to this release.

📚 Documentation