v0.1.173

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

完善 Grok/xAI 平台集成（授权、模型映射、媒体/Voice/搜索计费与调度门禁），并新增基于真实网关流量的被动式渠道监控 V2。

## 新增功能

- Grok 授权补齐：支持 SSO 登录与 refresh_token 重新授权，OAuth 会话跨实例共享，多副本部署可用
- Grok 网关能力扩展：新增图片/视频媒体路由、Voice TTS/STT/Realtime、custom voices 全量管理与 /v1/web_search
- Grok 计费维度扩展：视频支持按模型族 × 分辨率定价，搜索按每千次调用计价
- Grok 模型映射设置：可配置默认文本模型与跨客户端映射开关，运行时修改即时生效
- Grok free 档软门禁：按本地近 24 小时用量保护调度，free 额度与账单额度耗尽改为可恢复的临时下线
- Grok 调度增强：team+model 维度冷却、流式空闲换号、7d/30d 调度阈值窗口与命中理由展示
- 渠道监控 V2：基于真实网关流量被动聚合，不再向上游发探活请求，用户端提供健康 KPI、脉冲矩阵、趋势与模型/错误排行
- 渠道监控模式开关：系统设置中 v1（主动探测）与 v2（被动聚合）互斥切换，支持对普通用户隐藏 RPM/TPM
- 邮箱域名限量注册：白名单非空时，未列入白名单的域名按主域名（eTLD+1）归一化，每个主域名限注册一个账户，独立开关默认关闭
- 管理端账号测试支持 Grok 真实媒体预览，分组页支持按模型族 × 分辨率的视频价矩阵输入

## 优化改进

- 优化上游响应模型观察的热路径性能
- OpenAI OAuth 请求转发路由提示（routing hints），并停止注入已废弃的 legacy beta 头
- 用量单元格区分 Grok free 24h 与付费窗口，Grok/OpenAI 付费套餐徽章着色
- 管理端账号测试的媒体上传与文件选择器补齐中英文文案
- 导入探测队列改为有界并去重，避免批量导入打爆上游

## Bug 修复

- 修复 Gemini 原生生图在自定义模型名下记 $0 的问题，改按上游实际返回的图片张数计费
- 修复 Gemini 池模式下账号被 429 响应错误打上账号级限流
- 修复非流式生图时客户端断开导致图已生成却不扣费
- 修复 Grok 异步视频在 pending/失败任务上的误扣费与重复扣费
- 修复 Grok 流式路径下同一次搜索被重复计数
- 修复 Grok OAuth 客户端缺失导致的服务崩溃
- 修复 Grok 模型级配额软封会牵连同账号其它模型
- 修复管理端 Web 搜索配置在设置缺失时的空值处理与重置弹窗滚动

## 破坏性变更

- Grok 跨厂商模型映射默认关闭：升级后 gpt-* / claude-* 请求不再被隐式改写为 grok-4.5，改为按原模型透传。需保持旧行为的部署请在系统设置中显式开启「跨客户端模型映射」
- Grok 邮箱密码登录已隐藏并硬禁用：gateway.grok.password_auth_enabled 仅作配置兼容保留，服务端忽略该值
- 数据库迁移 220 会清理非 Grok 分组的历史视频定价残值（视频为 Grok/xAI 独有能力）



---

## 📥 Installation

**Docker:**
```bash
# Docker Hub
docker pull weishaw/sub2api:0.1.173

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.173
```

**One-line install (Linux):**
```bash
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

- [GitHub Repository](https://github.com/Wei-Shaw/sub2api)
- [Installation Guide](https://github.com/Wei-Shaw/sub2api/blob/main/deploy/README.md)