Skip to content

Sub2API 0.2.19-custom1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 03 Nov 08:14
· 199 commits to main since this release

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(默认)或 grpc
  • OTEL_SERVICE_NAME:服务名,默认 ai-gateway
  • OTEL_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.19

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.

📚 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-custom1

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/an-epiphany/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation