Sub2API M37

基于 Sub2API 的定制版 —— 内置 Gemini 3.7 Flash 完整支持（v0.1.181 + 3.7 补丁）。 MIT License，可自由使用与二次开发。

Sub2API 是"AI 订阅配额分发与管理"的开源网关，可将 Google Antigravity / ChatGPT 等订阅账号转化为 OpenAI / Anthropic / Gemini 兼容 API。本项目在其基础上补齐了 Gemini 3.7 Flash 的支持，并增强了思考强度参数透传与推理强度日志。

---

✨ 特性

内置 Gemini 3.7 Flash 完整支持

能力	说明
gemini-3.7-flash（基础名）	自动路由到 medium 变体（上游只认变体名，基础名直连会 404）
-high / -low / -medium / -tiered 变体	全部可用
思考强度参数透传	thinkingConfig.thinkingLevel（LOW / MEDIUM / HIGH）真实生效
推理强度日志	gemini 请求的思考档位记录到 usage_logs（后台请求日志可查）

官方 v0.1.181 全部功能

• Gemini 工具 Schema 上游字段清理
• Grok / OpenAI Responses 兼容性修复
• DeepSeek 自适应 API 协议（同一账号承接 Chat / Anthropic / Responses）
• OpenAI 重置卡按用量阈值自动使用、Fast mode service_tier 计费
• Kimi / 智谱 GLM / DeepSeek 供应商支持、渠道配额监控、谷峰定价

---

🚀 构建部署

环境要求

• Go 1.26+ / Node.js + pnpm（构建）
• Docker（部署，可选）

构建

# 前端（产物嵌入后端）
cd frontend
pnpm install
pnpm run build
cd ..

# 后端交叉编译（Linux）
cd backend
CGO_ENABLED=0 GOOS=linux go build -tags embed -ldflags="-s -w" -o sub2api ./cmd/server

部署

# 替换容器内二进制（docker compose 部署）
docker cp sub2api <容器名>:/app/sub2api
docker restart <容器名>
# 或替换 systemd 服务的二进制路径后重启

数据迁移

升级时数据库会自动迁移（ent）。建议升级前备份：

docker exec <postgres容器> pg_dump -U sub2api -d sub2api -Fc -f /tmp/backup.dump
docker cp <postgres容器>:/tmp/backup.dump ./backup.dump

---

⚙️ 使用前提（Antigravity 账号）

条件	说明
Google Antigravity 账号	AI Pro / Ultra 可完整使用 3.7（免费档位受限）
出口节点	美国（daily 端点地区限制——非美国会 400 location）
环境变量	GATEWAY_ANTIGRAVITY_FORWARD_BASE_URL=daily（官方客户端实际走 daily 端点，prod 对 AI Pro 必 429）
版本要求	Sub2API 需含 Gemni 3.7 目录（本项目已内置）

❓ FAQ

Q: 为什么 gemini-3.7-flash（基础名）请求 404？ 上游注册表只有变体名（-high/-low/-medium/-tiered），基础名不存在。本项目已做自动翻译（基础名 → medium），请确认使用的是本定制版。

Q: 思考档位在哪里控制？ 请求体 generationConfig.thinkingConfig.thinkingLevel（LOW / MEDIUM / HIGH）。Gemini 3.7 官方仅支持三档。

Q: 集群后台为什么看不到推理强度？ 本定制版已新增：后台请求日志（usage_logs）会记录思考档位（reasoning_effort 字段）。

Q: 429 / 400 location 怎么解决？

• 429 → 确认 GATEWAY_ANTIGRAVITY_FORWARD_BASE_URL=daily 已生效（docker exec <容器> env | grep GATEWAY）
• 400 location → 出口节点切到美国

---

📦 版本历史

版本	基础	说明
m37v6	v0.1.181	当前版本（含官方 0.1.179/180/181 功能）
m37v5	v0.1.178	首个独立发布版本

📄 License

MIT License。本定制版基于 Wei-Shaw/sub2api（MIT），保留原作者版权声明。