NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #37 by repository stars
Latest stable
v0.2.16
Last release 1 months ago
14 Oct 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 months old
796 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增面板 API 限流保护,防止高频请求冲击数据库;修复 WebSocket 多轮会话计费、模型映射统计口径等多项计费与统计准确性问题。
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.166
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.166
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增 ChatGPT Live(Frameless 实时会话)网关支持,并完整适配 Anthropic 新模型 claude-opus-5。
/v1/live 与 Codex /backend-api/codex/realtime/calls 实时会话转发,支持组级 Live 开关、并发租约控制与用量记录,用量筛选/导出新增 Live 请求类型+xxx@ 合法用户被永久误拒与并发注册竞态Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.165
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.165
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增聚合分组能力,一个分组可按模型路由规则将请求分发到不同平台的子分组;Ollama 账号支持 Cloud 官方用量自动刷新。
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.164
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.164
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
分组新增 OpenAI 推理策略控制,可按分组约束推理力度;修复优雅关停超时导致缓冲用量/计费记录丢失的问题,并集中修复多处移动端布局适配。
Grok
OpenAI / Codex
网关 / 转发
计费 / 用量
调度 / 监控
界面 / 移动端
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.163
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.163
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
客户端真实 IP 解析全面可配置:支持显式可信代理与自定义 IP 请求头,反向代理/Docker 部署下正确识别来源 IP;异步生图对象存储改为后台配置,保存即生效。
安全与计费
OpenAI / Codex
Grok
Anthropic 兼容
其他
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.162
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.162
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
安全防护全面开关化:敏感操作 step-up 2FA 与会话 IP/UA 绑定均改为默认关闭、按需开启,避免升级后误锁定;同时修复 Grok 受保护视频内容访问及一系列媒体链路问题。
Grok 相关
调度与路由
OpenAI/Codex 相关
其他
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.161
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.161
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增独立的提示词安全审计引擎:通过 OpenAI 兼容审计节点对用户提示词进行风险扫描,配套完整的管理端审计控制台;修复 Grok 媒体生成的多个可用性问题。
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.160
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.160
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
修复 v0.1.157 起纯 APIKey 分组无法使用 OpenAI 独立搜索的回归;反向代理部署下审计日志与会话 IP 绑定现在能正确记录真实客户端 IP。
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.159
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.159
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
Grok 上游端点管理全面升级:支持官方 API / 区域端点手动切换与快捷填充,并修复多项 OAuth 路由回归;管理端新增用户限额批量修改与分组一键复制。
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.158
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.158
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
操作审计日志:记录管理端变更与敏感读取操作,支持保留期清理与 2FA 门控的全量清空,新增操作日志管理页面
会话 IP/UA 绑定:登录会话绑定 IP 与 UA 指纹,任一变化即强制重新登录(默认开启,可在系统设置关闭)
敏感操作 step-up 2FA:账号/代理导出、备份创建与下载、S3 配置修改、提升管理员角色等操作需现场 TOTP 二次验证
管理员启用/停用 2FA 改用密码验证,避免通知邮箱收不到验证码
异步图片生成任务:新增异步生图任务 API,结果支持保存到对象存储
图片输入 token 独立计费:拆分图/文输入 token,支持全局与渠道级图片输入单价,用量日志单独记录
上游计费倍率:支持探测上游 Sub2API 计费倍率并按倍率调度 OpenAI 账号;新增 API Key 计费倍率自省接口
Grok 支持账号级自定义上游地址与请求头覆写,并提供 key 建号配置模板
Codex Agent Identity 独立导入入口
渠道监控一键复制:服务端复制监控配置,API Key 不出浏览器,副本默认禁用待人工启用
管理员充值支持返佣选项
订阅套餐支持币种标注,区分 $ 符号对应币种
批量账户操作按平台缩小调度重建范围,降低调度开销
复用调度快照账号载荷写入,减少重复序列化
修复 Haiku 模型请求未应用完整 Claude Code 伪装的问题
图片意图的 /v1/responses 请求只调度到支持 Responses API 的账号,避免降级到无法生图的路径
OpenAI 瞬态冷却改为按模型隔离,单模型报错不再冷却整个账号
Responses 请求被上游显式拒绝的字段自动剥离后重试
账号级请求体大小超限时自动切换账号重试
PAT alpha search 不可用时回退到 responses web_search
聊天补全端点拒绝图片模型请求
修复 Responses Lite reasoning 上下文归一化问题
修复 OAuth 账号图片工具用量计费不准的问题
拒绝畸形的 WS v2 事件,避免异常数据进入转发链路
修复 WS 入站连接关闭不干净的问题
Grok 放行被动声明的 Codex 图片工具
修复 Grok OAuth 建号缺少上游配置入口与 JSON 导入渲染崩溃的问题
修复平板设备上表格无法横向滚动的问题
修复 Codex Agent Identity 导入过期校验等问题
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.157
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.157
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
OpenAI 账号支持 Codex Agent Identity 认证,前端标明认证模式
账号管理新增安全的一键复制功能
/keys 与 /admin/groups 列表新增可选 ID 列
Server-Timing 指标扩展至已认证用户 Web API
OpenAI WebSocket 首消息超时支持配置
force-chat 账号直接桥接 Anthropic↔ChatCompletions,跳过 Responses 中间层
优化内容审核关键词匹配热路径性能
完善调度器缓存桶生命周期管理,复用重建批次内的账号查询
优化 Responses 流式事件边界刷新与图片生成意图判定
优化 Ops 队列深度账号查询与内容会话种子字段扫描
失败切换与 WebSocket 失败日志中记录代理主机,便于排查
统一 Grok 使用模板中的名称风格
修复客户端断开后 failover 静默终止、误报 502 账号耗尽的问题
修复 OpenAI API-key 透传遇 5xx 不触发 failover 的问题,并对透传上游错误脱敏
修复 OpenAI 原生 Responses 首输出无限等待的问题
修复并行 tool_use 产生幽灵 content_block_delta(index 错误)的问题
修复拼接 Responses 流事件解析、不完整流终结丢失、Read 工具参数流清洗等协议兼容问题
修复 Grok OAuth 凭证错误安全 failover、OAuth 池主动刷新与通用管理刷新路由问题
修复 Grok 视觉模型 image_url 内容桥接,并拦截图片模型误发 Responses 端点
修复 Grok Free Messages function tools 缓存失效问题
修复 GPT-5.6 长上下文账号成本统计错误
修复图片生成 JSON 完成边界与 OAuth 输出图片尺寸上报问题
修复 Responses Lite 工具声明兼容性,保留 Codex 图片 function tools
修复 Codex 根路径 models 兼容别名缺失问题
修复前端 DataTable 行缓存过期与 legacy Codex 配置模式丢失问题
修复 antigravity 手动输入的 refresh token 被覆盖的问题
修复调度器 degraded outbox 重复重建问题
修复 xAI 不安全 base URL 组件校验
修复 Web 静态资源 immutable 缓存误用于非指纹资源的问题
修复 OpenAI 主动重置次数在异常详情下丢失的问题
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.156
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.156
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
Grok 渠道健康监控:监控中心支持 Grok 平台健康检查,新导入的 OAuth 账号自动探活,账号列表显示 Free 计划徽标
Grok Web SSO 批量导入:批量粘贴 SSO key 自动转换为 Build OAuth 账号,失败自动跳过并汇总结果(原账号类型页的 SSO 卡片入口已移除)
系统日志支持按主机名过滤
管理后台新增可选开启的服务端耗时指标采集(server timing)
Grok 免费账号配额改用滚动 24 小时估算,并改进免费配额探测与用量展示
OpenAI 上游启用 HTTP/2 keep-alive PING,自动剔除失效的 Codex 连接
OpenAI 重置额度(reset credits)检测更准确
网关不再重复扫描请求体,降低大请求处理开销
Codex 模型列表支持经 API Key 上游代理获取,manifest 刷新更稳定并支持账号故障转移
修复调度器全量重建风暴:账号到期暂停、代理到期改投不再触发全量重建,并发重建自动合并,并修复事件延迟计算错误
修复 OpenAI 长上下文重复计费问题:长上下文计费改为账号级开关,默认关闭
修复原生 Responses 转发丢失工具 namespace 的问题(工具名原样透传,含 WSv2 链路)
修复 Grok reasoning 项 content 为 null 导致上游 422 报错的问题
修复 Responses Lite 丢失客户端图像工具导致图片无法显示的问题
修复图像生成问题:非流式请求保持连接不再超时断开,流式生成结果补齐最终状态
修复 /v1/messages 精确模型映射未按配置生效的问题
修复 Codex 图像生成工具重复注入导致与托管工具冲突的问题
修复 Codex 计划门控模型 400 后反复重试的问题(按账号冷却)
修复 Grok 免费账号提示词缓存路由标识不稳定的问题
Grok OAuth 媒体请求改走官方 API 路由
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.155
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.155
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
Grok 视频编辑与延长:网关新增视频 edit/extension 端点支持
Apple 容器部署:新增 apple-container.sh 部署脚本及配套文档
账号编辑弹窗支持手动覆盖 OpenAI 订阅档位 plan_type(仅 OAuth 账号)
API Key 列表最近使用 IP 查询性能优化,并新增数据库索引
内嵌静态资源设置长效 Cache-Control,直接部署时浏览器不再重复下载控制台资源
修复池模式同账号重试次数配置对 Anthropic/Gemini/通用转发路径不生效的问题
修复调度缓存出现异常时间时阻塞账号调度的问题
OpenAI WebSocket 入站会话增加生命周期上限,防止长连接无限期占用
Grok 账号支持第三方 API base URL,不再强制 api.x.ai
Grok API Key 账号支持上游模型同步
修复 /alpha/search(Grok Live Search)被内嵌前端拦截的问题
修复 Codex chat 补全桥接丢失 additional tools(自定义工具)的问题
修复流式 Anthropic 兼容层 max_tokens/content_filter 停止原因映射不正确的问题
修复 Read 工具参数未实时流式发送、依赖 .done 事件的问题
修复用量统计跨时区日期偏移,API 与面板时间范围保持一致
删除泄露内部 AI 渠道配置的废弃支付接口
补齐中文语言包 overview 和 misc 缺失的翻译
修复账号列表滚动抖动(小数据量关闭虚拟化并按行主键缓存行高)
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.153
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.153
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
Grok 平台能力大幅增强:新增 xAI API Key 账号支持与免费 OAuth 提示词缓存;Codex alpha/search 网页搜索接入转发并支持按次计费。
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.152
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.152
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
OpenAI Fast/Flex 策略支持用户级规则:规则可指定生效用户,用户专属规则优先于全局规则,便于为特定用户配置例外
修复 Codex 上游 originator 与 User-Agent 错配导致请求 404 的问题,覆盖普通转发、透传、WebSocket、用量探针与账号测试等路径
修复 GPT-5.6 计费与用量统计问题:补齐价格识别与模型别名匹配,完善用量统计口径
修复 Grok Responses 接口丢失 reasoning effort 参数的问题,兼容的参数将被保留
修复 Codex 图像生成时 image_gen 命名空间声明未正确剥离的问题
修复 setup-token 账号未纳入后台自动刷新、令牌到期后请求返回 401 的问题
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.151
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.151
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
GPT-5.6 缓存写入计费:支持 cache write token 独立计价与用量统计
parallel_tool_calls 兼容映射:Chat Completions 与 Responses API 互转时保留该字段(含显式 false)
GPT-5.6 计费与官方定价对齐,显式配置的缓存写入价格优先生效
升级 Codex 客户端版本至 0.144.1,修复 gpt-5.6-luna 模型请求 404
加固计费并发与支付恢复流程,防止并发场景下的余额与订阅状态异常
修复 remote compact 失败与重复计费:保留 SSE 事件流中的 compaction 输出项,上游等待期间向下游发送心跳,避免反向代理空闲超时断连(#3887)
修复 GPT-5.6 max 推理强度不被识别的问题;effort 提取改用模型候选列表,带后缀模型的用量元数据不再丢失
修复管理端用户用量明细 request_type 筛选不生效的问题
修复 Windows 环境下 WebSocket 连接重置未被正确识别的问题
补齐英文语言包缺失的翻译条目
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.150
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.150
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
> AI API Gateway Platform - 将 AI 订阅配额分发和管理
AI API Gateway Platform - 将 AI 订阅配额分发和管理
版本回退:版本徽章新增近 3 个历史正式版本的在线一键回退(release 构建),并提供脚本部署/Docker 部署的手动回退指引
用户角色管理:管理员创建/编辑用户时可设置角色(user/admin),内置"最后一个管理员不可降级"守卫并记录审计日志
用户 Token 排行:用量记录页新增用户 Token 排行,支持点击下钻到该用户的用量明细
用量页布局重构:明细区整合为单卡片三个 tab(用量明细/错误请求/用户排行)
新增延迟健康列:首字/总耗时合并展示并按阈值分档配色,管理端与用户端用量页共用
时长格式优化:超过 1 分钟显示为 Xm Ys、超过 1 小时显示为 Xh Ym
修复 Codex compact 流式请求收到 JSON 响应导致无限重连、重复消耗上游配额的问题,现正确合成为 Responses SSE 协议返回
修复 OpenAI /responses SSE 流的 response.failed 事件不应用错误透传规则、硬编码返回 502 的问题
修复 CC/Messages 协议转换路径按错误码配置的透传规则恒不命中的问题,并按账号平台正确匹配规则
修复 Grok 配额探测模型不稳定的问题
修复 Grok OAuth 授权、图像生成与用量展示流程中的多个问题
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.1.149
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.149
One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
Manual download: Download the appropriate archive for your platform from the assets below.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.