Repository navigation
Sub2API 0.2.19-custom1
Pre-release
Pre-release
·
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(默认)或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.