Repository navigation
Releases
Releases · an-epiphany/sub2api
Sub2API 0.2.21-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.21 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
OpenTelemetry
集成 OpenTelemetry，默认关闭，通过环境变量配置：
OTEL_EXPORTER_OTLP_ENDPOINT：OTLP 上报地址，设置后启用OTEL_EXPORTER_OTLP_HEADERS：上报请求头，如认证信息OTEL_EXPORTER_OTLP_PROTOCOL：http/protobuf（默认）或grpcOTEL_SERVICE_NAME：服务名，默认ai-gatewayOTEL_TRACES_SAMPLER/OTEL_TRACES_SAMPLER_ARG：采样策略LOG_ENV：环境标识，上报为deployment.environment，默认production
打包构建默认 JSON 日志
- CI 发版的二进制和 Docker 镜像默认
log.format=json，本地源码构建保持console；显式配置的log.format/LOG_FORMAT优先。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增 Claude Fable 5.2 与 Mythos 5.2 支持；OpenAI 用量与计费区分 30m/12h 缓存写入 TTL，并根据实例内存上限自动设定请求体内存预算，减少高并发下误报 503 的情况。
新增功能
- 支持 Claude Fable 5.2 与 Mythos 5.2：包括模型目录、Anthropic 预设、Bedrock 映射、OpenCode 配置和兜底定价（$8/$40 每百万 token，Fast 模式 2 倍）
- OpenAI 缓存写入计费按 TTL 拆分：渠道、分组、账号统计价卡新增独立的 12h 缓存写入价（GPT-5.6 / GPT-6 系列未配置时默认按输入价 2.5 倍；已配置通用写入价的价卡不受影响），管理员用量详情按实际 TTL 展示
- Antigravity 账号用量单元格新增「查询」按钮，可跳过缓存强制刷新用量
- EasyPay 支付实例可单独配置退款成功码（默认 1，可选 0），兼容退款以 code=0 表示成功的易支付网关
优化改进
- 请求体内存预算未配置时，自动取进程内存上限的 1/4（取物理内存、cgroup 限制、GOMEMLIMIT 中的最小值），最低 1GiB
- API 密钥列表不再等近 30 天用量统计返回才渲染，并为用量统计新增覆盖索引，大数据量下 /keys 页面不再长时间停在骨架屏
- 账号列表刷新时保留现有行和配额数值，不再整表闪烁成骨架屏
- 系统设置页的保存按钮改为吸附在视口右下角的浮标，长表单不用滚到底部也能保存
- 余额充值倍率支持最多 6 位小数，便于跟随实时汇率
- 安全审计任务入队后立即唤醒本进程 worker 认领，不再平均等待约 250ms
- OpenAI WebSocket 首 token 时间改为遵循管理员配置的 TTFT 口径，与 SSE 保持一致
- 客户端未提供会话标识时，Responses 会话种子在工具回合中保持稳定，减少粘性会话中途切换账号
- 内置 Claude Code CLI 版本基线升至 2.1.321
Bug 修复
- 修复 OpenAI 合成的 reasoning effort 未应用 effort 映射规则和上限校验的问题；保留已配置的 GLM 降级语义
- 修复 OpenAI 显式配置的模型级冷却规则对 overloaded/slow_down 及流内 503 不生效的问题；关键词只匹配实际错误字段
- 修复 Codex 元数据事件（codex.rate_limits 等）提前提交响应流，导致后续上游过载无法 failover 的问题
- 修复原生 Responses WebSocket 在后续轮次限流时重放首帧，可能导致任务上下文错乱的问题（现以 1013 关闭，由客户端重连）
- 修复 OpenAI OAuth 池化 WebSocket 在未声明搜索的连接上发起 web_search 被上游拒绝的问题
- 修复 Codex Desktop 注入的页面上下文导致首个 Responses 请求返回 400 的问题
- 修复原生 Codex 生图请求因心跳提前写出 200、掩盖上游错误状态码的问题
- 修复 /v1/responses 重建函数调用时丢失 encrypted_function_args 与 namespace 的问题
- 修复 CC Switch 的 reasoning 封装被当作 encrypted_content 发往上游的问题
- 修复 Anthropic 兼容路径（Chat Completions / Responses）忽略账号自定义错误策略的问题
- 修复 Gemini 兼容入口非流式响应把思考摘要混入正文的问题
- 修复 Antigravity 并行工具结果中的图片打断 functionResponse 序列导致上游 400 的问题
- 修复 Antigravity Pro 账号 Argon 配额与其他 Gemini 配额共用冷却、互相误伤的问题
- 修复账号信息加载失败时已占用的并发槽位未释放、要等 TTL 过期才恢复的问题
- 修复刷新令牌并发轮换时同一令牌可被重复使用的问题
- 修复定价目录哈希与内容版本不一致时，后续同步一直被跳过的问题
- 修复 Sonnet 5.5 兜底缓存读取价格错误的问题（改为 $0.10 每百万 token）
- 修复 OpenAI 普通输入免费时 Fast 倍率丢失的问题
- 修复含非法 UTF-8 的 Responses 请求体被当作上游可重试错误的问题，现直接返回 400
升级指南
- 本次新增两个数据库迁移，升级时自动执行。其中 249 在 usage_logs 上用 CONCURRENTLY 建索引，不锁表，但表较大时首次启动会耗时较长
- 请求体内存预算的配置键是 gateway.request_body_memory_budget_bytes（v0.2.20 发布说明误写为 security.*），需要固定值时请显式设置
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.21
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.21One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.21-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.21-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.20-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.20 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
OpenTelemetry
集成 OpenTelemetry，默认关闭，通过环境变量配置：
OTEL_EXPORTER_OTLP_ENDPOINT：OTLP 上报地址，设置后启用OTEL_EXPORTER_OTLP_HEADERS：上报请求头，如认证信息OTEL_EXPORTER_OTLP_PROTOCOL：http/protobuf（默认）或grpcOTEL_SERVICE_NAME：服务名，默认ai-gatewayOTEL_TRACES_SAMPLER/OTEL_TRACES_SAMPLER_ARG：采样策略LOG_ENV：环境标识，上报为deployment.environment，默认production
打包构建默认 JSON 日志
- CI 发版的二进制和 Docker 镜像默认
log.format=json，本地源码构建保持console；显式配置的log.format/LOG_FORMAT优先。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增基于 OAuth 授权的管理 MCP 接口，并完善管理员密钥的细粒度权限；同时全面治理网关请求体内存与读写超时，提升高并发下的稳定性。
新增功能
- 管理 MCP：新增 OAuth 认证的管理 MCP 接口及前端授权确认/连接管理页面，需显式配置 MCP_PUBLIC_URL 才会启用（默认关闭）
- 管理员密钥：补全权限项（统计、OpenAI OAuth、邀请等）与中英文权限展示，新增需输入确认文字才能开启的「全权兼容模式」
- 注册邮箱精确黑名单：支持批量粘贴（上限 20000 条），按收件箱身份匹配 Gmail 点号/+后缀变体，保存时可批量禁用命中的已注册用户
- OpenAI 生图账号支持按 1K/2K/4K 尺寸档位分流，未指定尺寸时按档位偏好逐层选号
- 新增 gateway.disable_openai_transport_error_cooldown 开关，可关闭 OpenAI 传输错误冷却
- Antigravity 账号用量显示每个配额组真实的 5 小时与每周窗口，Pro 套餐的独立 Argon 配额单独成行
- Antigravity INTERNAL 500 账号惩罚档位可通过环境变量配置
优化改进
- 网关请求体内存预算、上游/下游读写超时与后台任务全面加上限，减少慢连接和大请求对实例的影响
- 网关热路径减少 JSON 拷贝与重复解析（thinking 过滤、Codex 引导/压缩判断、Gemini 流增量等），RPM 覆盖与分组隐私门控不再每请求查库
- 请求体读取失败按超时（408）、客户端断开（499）、截断、解码错误分类返回，并记录不含内容的诊断日志
- 打通 GPT Image 2.6 原生图片链路，保留 complexity 与原生编辑选项
- Antigravity 连接测试改为发送管理员填写的提示词并返回模型真实回复
- Kimi 并发上限 403 改用短冷却，不再长时间下线账号
- Antigravity 图像模型的 INTERNAL 500 只冷却该模型，不再连带整个账号进入惩罚
- 用户使用记录导出每页 1000 条，遇面板限流 429 按 Retry-After 等待后重试
- Codex 密钥导出与 CC Switch 导出默认模型统一改为 GPT-6.1 Sol，并启用实时联网搜索、保留图片配置
- GPT-6.1 Terra 使用官方 Codex 描述（上下文窗口 500k），校验 effort 与兼容缓存键
- 错误透传规则可覆盖内置的请求体过大 413
- MCP 客户端 ID 过长时前端截断显示，MCP 关闭时隐藏入口
Bug 修复
- 修复 Anthropic setup-token 账号在无 5h 限制时丢失每周用量的问题
- 修复长会话中 cyber transcript 误拦截的问题（Wei-Shaw#8519）
- 修复异步生图任务因请求体内存预算被提前释放而全部 503 的问题
- 修复 Bedrock EventStream 帧长度未校验即分配内存的问题
- 修复 Gemini 上游 SSE 行与 Antigravity 非流式响应读取无上限的问题
- 修复补丁预算在 failover 中累积导致误拒绝的问题
- 修复 OpenAI OAuth 透传对 codex 模型空 instructions 本地返回 403 的问题，response.instructions 回显按客户端原值还原
- 修复非流式 /v1/responses 在上游返回 incomplete/cancelled 或缺少 Content-Type 的 SSE 时未返回 JSON 的问题
- 修复 WebSocket HTTP 桥接未应用 Codex 指纹收敛的问题
- 修复 OpenAI WS 透传部分轮次未记录首 token 时间的问题
- 修复强制路由模式下仍发起 responses 探测的问题
- 修复生图尺寸溢出选号时错误改写会话粘性绑定的问题
- 修复 GPT Image 账号生图测试参数错误的问题
- 修复 API Key 校验时客户端断开或密钥格式错误被报告为 500 的问题
- 修复 Grok Voice 请求体读取失败被误报为 400 并回显原始 socket 错误的问题
- 修复 Grok 委派消息输入在 Responses 中未规范化的问题
- 修复 apicompat 转换丢失缓冲 reasoning 内容、完成响应丢失消息内容字段的问题
- 修复 Gemini 原生 function response 中工具媒体丢失的问题
- 修复 Antigravity 直连 Gemini 流式响应异常、responseJsonSchema 未改写为 responseSchema 的问题
- 修复 Antigravity 转发时残留旧系统身份、误删携带任务内容的身份前导的问题
- 修复 Cloudflare REST messages 请求携带 beta 查询参数的问题
破坏性变更
- 请求体内存预算：新增 security.request_body_memory_budget_bytes（默认 1GiB），超出时返回 503 + Retry-After；设为 0 可禁用
- 读写超时：新增 security.request_body_read_timeout_seconds 与 downstream_write_timeout_seconds（默认均 120 秒，0 禁用），上传单次读取停滞超时返回 408
- 客户端断开后的上游 drain 窗口改为有上限，超时截断会影响该请求的计费口径；会话缓存改为有界
- GPT-6.1 Terra：OAuth/setup-token 订阅请求超过 272k 不再收取长上下文附加费；Codex 窗口升至 500k 后 API Key 请求越过 272k 更频繁，按 2x/1.5x 计费；Terra 兼容路径的 minimal effort 改为返回 400
- 新增数据库迁移 249_mcp_oauth.sql，升级时自动执行
升级指南
- 容器内存较小或并发长上下文请求较多的部署，请按实际情况调整 security.request_body_memory_budget_bytes，详见 deploy/EDGE_SECURITY.md
- 如需启用管理 MCP，配置 MCP_PUBLIC_URL（需 HTTPS，路径为 /api/v1/mcp）
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.20
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.20One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.20-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.20-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.19-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.19 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
OpenTelemetry
集成 OpenTelemetry，默认关闭，通过环境变量配置：
OTEL_EXPORTER_OTLP_ENDPOINT：OTLP 上报地址，设置后启用OTEL_EXPORTER_OTLP_HEADERS：上报请求头，如认证信息OTEL_EXPORTER_OTLP_PROTOCOL：http/protobuf（默认）或grpcOTEL_SERVICE_NAME：服务名，默认ai-gatewayOTEL_TRACES_SAMPLER/OTEL_TRACES_SAMPLER_ARG：采样策略LOG_ENV：环境标识，上报为deployment.environment，默认production
打包构建默认 JSON 日志
- CI 发版的二进制和 Docker 镜像默认
log.format=json，本地源码构建保持console；显式配置的log.format/LOG_FORMAT优先。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增按操作与资源范围授权的管理员 API Key；OpenAI / Composite 分组支持按实际出图张数计费，并新增 GPT-6.1 Terra 模型支持。
新增功能
- 管理员 API Key：可按操作和资源范围授权，支持过期时间和 IP 白名单；只保存不可逆摘要，撤销记录保留用于审计
- 按张计费：OpenAI 和 Composite 分组新增「按张计费」开关（默认关闭），一次生成多张图时按上游实际返回的张数计费，只对专用图片端点生效
- OpenAI：支持 GPT-6.1 Terra 模型
- Gemini：同账号重试次数可通过 gateway.max_same_account_retries_gemini 配置（默认 4，范围 0–10）
- Grok：管理端新增账号模型目录诊断，可查看来源、可信状态和与本地映射的差异；手动同步和后台观察统一使用同一套解析规则
优化改进
- Gemini：刷新默认模型列表，移除已停用的 2.0/2.5 系列和 3-pro-preview；连接测试默认模型改为 gemini-3.5-flash
- Gemini：分组内账号都配置了模型映射时，/v1beta/models 列表和详情按声明的模型返回，与 /v1/models 口径一致
- Gemini：绑定显式缓存的请求在池模式上游网关账号上，按配置在同一账号重试
- 国产 Coding Plan 账号遇到请求频率型 429 时改为秒级冷却，不再停调到 5h 窗口结束
- 模型列表刷新在并发冷启动时不再重复请求上游
- Grok：原生 Responses 和各转换路径都会记录上游原始响应模型，便于审计
Bug 修复
- 修复 Gemini 以 fileData 形式返回的图片未计费的问题
- 修复渠道按次计费的图片档位丢失 token 用量的问题
- 修复 DeepSeek V4 Pro 在 9 月 14 日之后定价失效的问题
- 修复 DeepSeek prompt_cache_hit_tokens 未计为缓存读取的问题
- 修复 OpenCode 转发 DeepSeek 时 developer 角色导致 422 的问题
- 修复 Antigravity 非流式畸形工具调用返回空成功响应的问题
- 修复超大 multipart 图片上传被静默截断的问题，现在直接拒绝
- 修复分页参数过大时偏移量溢出导致 500 的问题
- 修复管理员保护规则校验返回 500 的问题，现返回 400
- 修复保存渠道时覆盖 web_search_emulation 平台维度的问题
- 修复模型广场分组模型定价被图片兜底档位覆盖的问题
- 修复 Grok 模型目录快照被失败请求、乱序请求或旧表单覆盖的问题
升级指南
- 本版本包含数据库迁移 247（scoped_admin_api_keys 表）和 248（groups.image_count_billing 列），启动时会自动执行
- Gemini 默认模型列表已移除 2.x 系列；仍需使用这些模型的账号请自行在白名单或模型映射中配置
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.19
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.19One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.19-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.19-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.18-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.18 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
修复多条流式链路在客户端断开或上游异常中断时的计费与收尾问题；Vertex 账号支持配额上限。
新增功能
- Vertex 账号支持配额上限：可设置总额/日/周上限，用满停止调度并发送额度通知，用量列显示配额进度条
- 分组「允许当前分组生图」开关对 Gemini / Antigravity / 混合分组生效，关闭时 Gemini 系生图请求返回 400
优化改进
- 账号管理页的平台与状态筛选条件刷新后保留
- 调度快照解码结果常驻进程内存，降低大分组选号时的 Redis 流量与 CPU 开销
- 非 Antigravity 请求不再每次查询单账号分组快照，减少数据库回源
- 账号配额累加按已设置的周期选择更轻的 SQL，缩短计费事务持锁时间
- 模型映射签名计算改为零分配，降低选号开销
Bug 修复
- 修复 Anthropic 账号 chat/responses 兼容流式在客户端断开后 usage 记为 0 的问题，改为读完上游再计费
- 修复 Anthropic 账号兼容流在上游未正常结束时仍报成功的问题，改为返回协议内错误事件，流内 error 支持换号重试
- 修复 Gemini 流式中途客户端断开时不计费的问题，改为按已收集用量计费
- 修复 Gemini prompt 被拦截且只返回缓存命中时 input_tokens 与费用为负的问题
- 修复 Grok 4.7 Fast 按普通 Grok 4.7 价格计费、少收一半的问题，改按官方 Fast 价格计费
- 修复 Cloudflare 1010 拦截被当作账号 403 故障、导致账号受处罚的问题（对所有平台生效）
- 修复模型限流快照原地写入共享对象可能引发并发读写崩溃的问题
- 修复 Gemini 兼容接口工具参数中 const / 注解字段处理不当导致的请求失败
- 修复 DeepSeek 图片输入同时携带 image_url 与 url 造成重复负载的问题
- 异步生图转存下载改为拒绝内网、回环等非公网地址（含每次重定向），非图片内容直接判定失败
破坏性变更
- 混合（composite）分组升级后不会自动开启生图开关；未开启的混合分组发起 Gemini 生图请求会返回 400，需要时请到分组设置中手动开启
- grok-4.7-fast / grok-4.7-build-fast 计费价格调整为官方 Fast 价格（标准版的 2 倍）
升级指南
- 升级时会自动执行迁移 246，把已有 Gemini / Antigravity 分组的生图开关设为开启，无需手动操作
- 使用混合分组提供 Gemini 生图的，升级后请确认该分组已开启「允许当前分组生图」
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.18
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.18One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.18-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.18-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.17-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.17 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
Antigravity / Gemini 支持 Gemini 4 Argon（含计费与上游模型目录同步），Gemini 兼容入口支持思考档位与流式思考摘要；同时集中修复支付退款、易支付查单等多处资金链路问题。
新增功能
- Gemini 4 Argon：Antigravity、Gemini API、Gemini CLI 支持 gemini-4-argon（low/medium/high），并补齐计费价格
- Antigravity 模型目录：同步上游模型目录时按账号实际端点拉取，并保存上下文窗口、图像输入、思考等能力信息
- Gemini 兼容入口思考档位：chat/messages 兼容入口转发 reasoning_effort / thinking 为 Gemini 思考配置，流式返回思考摘要
- 最小输出 token 可配置：新增 gateway.min_output_tokens（默认 128，最低 16），作用于各协议转换路径
- OpenAI API Key 账号支持 Web Search 模拟：Claude Code 走 OpenAI 分组的 /v1/messages 也可启用 web_search 模拟
优化改进
- Vertex 共享容量不足的 429 不再冷却账号，改为同号退避重试，避免绑定显式缓存的请求直接 503
- Vertex 服务账号已被删除时将账号置为 error 并换号，不再持续调度返回 502
- 账号管理页恢复筛选项直接平铺展示，并优化窄屏布局
Bug 修复
- 修复易支付（彩虹易支付 / ZPay）查单参数无法被识别、数字字符串解析失败的问题，回调确认后再入账
- 修复退款处理中余额/订阅扣减时机问题：退款待定期间保留扣减，网关确认失败后原子回退
- 修复支付宝退款无法查询状态的问题，查询异常保持待定、未找到记录延迟判定失败
- 修复不支持的订单类型导致支付回调无法确认的问题，下单时校验订单类型
- 修复 Stripe 支付页 client_secret 经 URL 传递的问题，改为从本地订单快照读取
- 修复 GPT-5.5 退役后仍向 ChatGPT 订阅账号调度和展示该模型的问题（API Key 账号不受影响）
- 修复 Responses 对象缺少 created_at 导致 grok-build 等客户端反序列化失败的问题
- 修复 composite 分组模型归属歧义时 OpenAI OAuth 凭据可能误入 Anthropic 管线的问题
- 修复自适应账号在原生 Anthropic 网关和 count_tokens 路径忽略 Anthropic 协议 base URL 的问题
- 修复同一用户多个 Codex 工作区导入时互相覆盖的问题
- 修复 Antigravity 丢失 tool_result 内图片、原生 Gemini functionCall/thoughtSignature，以及 composite 分组 /v1beta 路由被拒的问题
- 修复 Antigravity Claude 5.5 档位模型按子串匹配被超额计费的问题，并保留旧版默认模型透传
- 修复 Gemini 首次 401 在同一请求内被重复判定导致账号直接停用的问题
- 修复智谱 GLM Coding Plan 5 小时/每周用量窗口标反的问题
破坏性变更
- GPT-5.5 订阅退役：ChatGPT OAuth / SetupToken 账号不再调度 gpt-5.5，模型列表中也不再展示；若无可用账号，请求返回 model_not_found。API Key 账号不受影响
升级指南
- 使用 ChatGPT 订阅账号承接 gpt-5.5 的站点，请检查账号模型映射与默认模型，将 gpt-5.5 显式映射到可用的替代模型，或改由 API Key 账号承接
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.17
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.17One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.17-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.17-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.16-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.16 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
Gemini 支持显式上下文缓存（AI Studio / Vertex / 自建网关上游），并新增 Claude Haiku 5.5 模型适配。
新增功能
- Claude Haiku 5.5：全链路适配模型注册、推理强度、定价与计费，并接入 Responses 桥接
- Gemini 显式上下文缓存：支持创建、续期、删除缓存，内置官方存储价并按 Pro / Flash 系列兜底，存储费按 API Key 额度与订阅额度预留校验
- Gemini Vertex（Agent Platform）：支持 API Key 认证，服务账号支持同步上游模型列表，模型列表与详情接口支持 Vertex 账号
- Gemini AI Studio：适配新的 AQ. 格式 Key
- 临时不可调度规则新增作用范围选项：可选择命中后暂停整个账号或只冷却当前模型，未设置的存量规则行为不变
- 分组名称与描述支持多语言
- 运维请求详情表新增账号名称列
优化改进
- GPT-6.1 Sol 订阅账号不再收取长上下文附加费
- GPT-6.1 Sol 生成上下文默认值提升至 500k
- Gemini 3.6 Flash 兜底价改为官方优惠价
- 第三方上游 API Key 与 Vertex 账号不再套用 AI Studio 等级和模拟配额
- Vertex 显示名改为 Agent Platform (Vertex)
- Kimi 国际版 Coding 端点（api.kimi.ai）支持配额查询
Bug 修复
- 修复上游拒绝结构化输入时 Chat 回退重试的问题，并保留 Responses 语义、避免不安全重试
- 修复 Kimi / DeepSeek / MiniMax 等非 OpenAI 账号被注入 Codex 图像生成桥接导致 400 的问题
- 修复 Gemini 引用不存在的缓存返回 403 时账号被停用并换号的问题
- 修复 Gemini 工具结果中的图片丢失问题
- 修复 Antigravity 图像模型限流影响同账号其他模型的问题
- 修复显式模型级 401 规则在故障转移、计数、Bedrock 等入口未生效、仍整号置错的问题
- 修复 Gemini 原生路由网关本地错误在运维中的归类问题
- 修复 Gemini 授权链接生成失败时错误信息丢失的问题
- 修复同步上游模型失败时未显示后端错误原因的问题
- 修复风控审核范围中残留已删除分组的问题
- 修复分组 RPM 覆盖加载过期数据的问题，并拒绝非正数的倍率修改
- 修复支付二维码倒计时漂移、用量倒计时切回标签页不刷新的问题
- 修复渠道监控 v2 设置无法添加缺失平台、自动刷新不更新缓存可用性的问题
- 修复运维自定义时间范围未按本地时区初始化的问题
- 修复下拉选择框在输入法组字时键盘输入被打断的问题
- 修复账号列表中分组名称显示不全的问题
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.16
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.16One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.16-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.16-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.14-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.14 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
修复两处安全问题：全新安装不再使用可猜测的默认管理员账号，并封堵 EasyPay 支付回调伪造漏洞。
Bug 修复
- 修复全新安装默认管理员邮箱固定为 admin@sub2api.local 且不校验密码强度、易被暴力破解的问题：未设置 ADMIN_EMAIL 时自动生成随机登录邮箱（admin-<随机串>@sub2api.local，启动日志中输出），自动安装时校验 ADMIN_PASSWORD 长度（8-72 字节）与 ADMIN_EMAIL 格式（Wei-Shaw#7850）
- 修复 EasyPay 下单签名可被重放为支付成功回调、无需商户密钥即可伪造到账的安全漏洞：return_url 不再保留客户端查询参数，回调验签拒绝非标准通知参数（#7881）
- 修复使用远程 Codex 模型目录时，「使用密钥」生成的 Codex 配置缺少 api_key_model_discovery 导致无法通过 API Key 发现模型的问题
破坏性变更
- 全新自动安装（AUTO_SETUP）时，若显式设置的 ADMIN_PASSWORD 少于 8 字节或超过 72 字节、或 ADMIN_EMAIL 不是可登录的合法邮箱，安装将直接失败；已有管理员或已有用户的部署不受影响，不会因此阻断启动
- 未设置 ADMIN_EMAIL 的全新安装，管理员登录邮箱不再是 admin@sub2api.local，请从首次启动日志中获取生成的邮箱
升级指南
- 已有实例无需任何操作即可升级；若仍在使用旧默认邮箱 admin@sub2api.local 或弱密码，建议在后台修改管理员邮箱与密码
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.14
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.14One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.14-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.14-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.13-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.13 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
- 修复创建 TypeSafe API Key 账号时，因默认开启上游计费自动探测而返回 400 无法创建的问题
- 修复特定情况下请求用量未能正常结算的问题
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.13
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.13One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.13-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.13-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.12-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.12 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增 TypeSafe Jev System One 原生平台支持；充值页新增优惠阶梯，支持「赠金」与「折扣」两种模式。
新增功能
- TypeSafe 平台：原生支持 Jev System One（/v1/systemone），含账号创建与测试、分组/渠道/配额/Composite 路由、计费、内容审核与提示词审计覆盖
- 充值优惠阶梯：后台可配置「满 X 送 Y%」赠金或「满 X 打折」折扣模式及 Markdown 活动文案，充值页快捷金额显示促销价签，订单与支付结果展示赠送额度
- 账号列表优先级快捷调整：悬停显示 -/+ 按钮、点击可直接输入，连续点击自动合并为一次保存
- API 密钥列表支持按分组名称排序
优化改进
- Grok OAuth 请求身份头对齐官方交互式 CLI 1.0.46
Bug 修复
- 修复 Grok 因 CLI 版本过低返回 426 的问题
- 修复 Antigravity 上游错误体原样返回给客户端、可能泄露账号池项目 ID 与服务账号邮箱的问题
- 修复邮箱验证码并发猜测可突破 5 次尝试上限的问题；重置密码 token 改为哈希存储并原子单次消费
- 匿名订单查询接口 /payment/public/orders/verify 增加按 IP 限流（20 次/分钟），防止订单号枚举
- 修正账号「自定义错误码」设置的警告文案，准确描述其实际作用
升级指南
- 本版本包含数据库迁移（payment_orders 新增 bonus_amount 列、平台约束加入 typesafe），启动时自动执行
- 重置密码 token 改为哈希存储，升级前已发出但尚未使用的重置密码链接将失效，用户需重新申请
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.12
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.12One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.12-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.12-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Sub2API 0.2.11-custom1
AI API Gateway Platform - 将 AI 订阅配额分发和管理
基于上游 v0.2.11 同步，包含以下自定义功能。
自定义功能
OpenAI 403 处理策略
rate_limit.openai_403_ignore：设为true时跳过 OpenAI 403 的全部账号副作用，不计数、不临时下线、不永久禁用，账号保持可用，并将原始 403 响应直接透传给客户端。rate_limit.openai_403_disable_threshold：连续 403 次数达到该阈值时才永久禁用账号；未达到阈值时仅临时下线。设为小于或等于0时使用内置默认值3。
上游更新
AI API Gateway Platform - 将 AI 订阅配额分发和管理
新增 GPT-6.1 Sol 模型支持和 Claude 原生限额重置兑换；余额模式新增在途额度预占，防止并发请求导致透支。
新增功能
- 支持 GPT-6.1 Sol 模型（含定价、模型目录与各兼容入口转换）
- Claude 账号支持兑换原生限额重置：查询到可兑换额度后，可在账号列表中经二次确认一键重置
- 使用密钥弹窗的 Codex 配置支持远程模型目录（Codex 0.156.0+），旧版客户端仍可选择本地文件模式
- 识别 ChatGPT 最新订阅套餐类型，账号套餐标签显示更准确
- 新增 API Key 创建数量与频率限制：每用户最多 200 个有效 Key、每小时最多创建 60 次（可配置，0 表示不限制）
优化改进
- 支持 Astra Ultrafast 模型的能力识别与计费
- 开启「仅限 Claude Code」并配置了降级分组的分组，其 OpenAI 兼容入口（Chat Completions / Responses）改走降级分组，不再直接返回 403
Bug 修复
- 修复余额模式下多个高成本请求并发时可能透支余额的问题：请求准入时按预估成本预占在途额度，计费完成后释放
破坏性变更
- API Key 创建限制默认开启：单用户有效 Key 超过 200 个或一小时内创建超过 60 次时，将无法继续创建。如需调整，修改配置
api_key_create.max_active_per_user/api_key_create.max_per_user_per_hour（设为 0 表示不限制） - 余额在途预占默认开启：余额较低的用户在并发请求时，可能比以前更早被拒绝。可通过
billing.inflight_reservation配置关闭或调整
📥 Installation
Docker:
# Docker Hub
docker pull weishaw/sub2api:0.2.11
# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.2.11One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
Image
ghcr.io/an-epiphany/sub2api:0.2.11-custom1
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/an-epiphany/sub2api:0.2.11-custom1One-line install (Linux):
curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bashManual download:
Download the appropriate archive for your platform from the assets below.