Skip to content

Sub2API 2.23.1

Latest

Choose a tag to compare

@github-actions github-actions released this 19 Nov 18:13
· 7 commits to production since this release
00e0079

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

v2.23.1 新增 OpenAI 兼容视频端点和可选的生图最低收费。管理员可以在同一页面管理渠道、账号和利润,并为供应商选择成本来源。

视频与生图

  • OpenAI API Key 账号可在「端点能力」中启用 OpenAI Videos。有媒体生成权限的分组可通过 POST /v1/videos 创建任务,使用原 Key 和网关返回的任务 ID 查询状态或下载内容。创建时需给出正整数秒数。渠道支持按次或按秒定价,首次查询到完成状态或成功下载时结算一次。该能力默认关闭。视频接入说明
  • MiniMax H3 支持显式映射到兼容的上游视频型号,完成响应中的顶层 url 和 metadata.url 均可用于结算。MiniMax H3 说明
  • 按 token 计费的 OpenAI 生图分组可设置每张最低收费,默认留空。客户端在 Images 生成或编辑请求中发送 X-Image-Usage: billing 可取得实际结算金额和折算用量。后台恢复任务先完成扣费时,前台仍可返回图片;流式请求收到 JSON、空图片响应及混合 partial/completed 事件均按实际结果处理。生图计费与回执

渠道、钱包与利润

  • 「渠道配置」合并渠道管理、利润运维和账号运维入口。利润报表在同一窗口翻页、排序时可复用汇总,历史渠道归属保留原有统计口径。渠道配置
  • 数据库迁移 388_provider_profit_cost_mode.sql 为既有供应商连接保留「钱包消费」,新增连接默认使用「倍率估算」。钱包读数缺失时显示不可用。回滚到旧二进制后,旧版会按钱包口径统计。
  • New API 钱包按上游公布的 USD、CNY 或自定义币种显示。采购成本的「应用美元汇率」可逐账号关闭,默认对非 CN 平台采用固定系数 7,CN 平台采用 1。钱包显示汇率与采购成本系数分别配置。单账号支持关闭请求余额不足通知。New API 钱包与成本
  • 账号性能列表从共享 Redis 快照读取统计,并限制数据库回源并发。用量 CSV 导出每页读取 1000 条,遇到 429 按 Retry-After 续传。

网关兼容与其他修复

  • 新增默认关闭的 OpenAI 旧版兼容模式,供需要 v2.20 风格普通转发策略的部署使用。严格模式下,加密历史恢复因控制字段变化被拒绝时,Ops 错误详情会显示各字段的比较结果,保留字段内容的隐私。兼容模式说明
  • 第一方 ChatGPT/Codex HTTP Responses 出站请求默认使用 zstd 压缩,支持 gzip 或关闭;其他兼容上游可按 origin 单独配置。上游明确拒绝压缩的请求会返回错误,避免重复提交。
  • 修复 Grok 定时检测与限流恢复的状态更新顺序、密钥表单分组下拉框宽度,并支持在 Pelican 作品大图预览中使用指针锁定。

启用了生图保底的分组在回滚前应先停用,旧版本会忽略最低收费字段。完整版本差异


📥 Installation

Docker:

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

One-line install (Linux):

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

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

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

📚 Documentation