Antigravity CLI 反向代理服务 —— 将 Antigravity CLI 后端以 OpenAI / Anthropic / Gemini 兼容的标准 API 格式对外暴露,支持多凭证池管理、自动重试与 WebUI 管理面板。
- 多格式 API 兼容 — 同时支持 OpenAI、Anthropic、Gemini 三种请求/响应格式
- 凭证池管理 — 多 Google OAuth 凭证随机负载均衡,自动令牌刷新
- 自动封禁与冷却 — 凭证返回 401/403/500 时自动禁用;按模型级别设置冷却期
- 失败重试 — 可配置重试次数,失败时自动切换凭证
- 流式与非流式 — 完整支持 SSE 流式输出,非流式请求内部走流式合并
- Thinking / 工具调用 / 图片生成 — 完整支持推理 token、函数调用及图片生成
- WebUI 管理面板 — 凭证管理、配置修改、调用日志与统计
- Docker 部署 — 提供 Dockerfile 与 docker-compose 一键部署
pip install -r requirements.txt
python main.pydocker compose up -d自定义配置:
ACLI2API_PASSWORD=your-api-key ACLI2API_PANEL_PASSWORD=your-panel-pwd docker compose up -d服务默认监听 17342 端口,管理面板访问 http://localhost:17342/。
| 端点 | 方法 | 格式 | 说明 |
|---|---|---|---|
/v1/chat/completions |
POST | OpenAI | Chat Completions |
/v1/messages |
POST | Anthropic | Messages API |
/v1beta/models/{model}:generateContent |
POST | Gemini | 非流式生成 |
/v1beta/models/{model}:streamGenerateContent |
POST | Gemini | 流式生成 |
/v1/models |
GET | OpenAI | 模型列表 |
/v1beta/models |
GET | Gemini | 模型列表 |
/health |
GET | — | 健康检查 |
API 请求支持以下任一方式传递密钥:
Authorization: Bearer <password>x-api-key: <password>x-goog-api-key: <password>- URL 参数
?key=<password>
管理面板使用独立的 PANEL_PASSWORD 通过 Bearer Token 认证。
通过环境变量配置,统一使用 ACLI2API_ 前缀。优先级:环境变量 > 数据库 > 默认值。
| 环境变量 | 默认值 | 说明 |
|---|---|---|
ACLI2API_HOST |
0.0.0.0 |
监听地址 |
ACLI2API_PORT |
17342 |
监听端口 |
ACLI2API_PASSWORD |
sk-xxxxxx |
API 访问密钥 |
ACLI2API_PANEL_PASSWORD |
admin |
管理面板密码 |
ACLI2API_PROXY_URL |
— | HTTP/SOCKS 代理地址 |
ACLI2API_RETRY_ENABLED |
true |
启用失败重试 |
ACLI2API_RETRY_MAX_RETRIES |
5 |
最大重试次数 |
ACLI2API_AUTO_BAN_ENABLED |
true |
启用自动封禁 |
ACLI2API_DEFAULT_COOLDOWN_SECONDS |
14400 |
默认冷却时间(秒) |
完整配置项参见 config.py。
| 系列 | 模型 |
|---|---|
| Gemini | gemini-3-flash-agent, gemini-3.1-flash-lite, gemini-3.1-flash-image, gemini-pro-agent, gemini-3.1-pro-high, gemini-3.1-pro-low, gemini-3.5-flash-low, gemini-3-flash, gemini-2.5-pro |
| Claude | claude-sonnet-4-6, claude-opus-4-6-thinking |
| GPT | gpt-oss-120b-medium |
动态模型列表从上游 API 获取并缓存 5 分钟。
访问 http://localhost:17342/ 进入 WebUI,功能包括:
- 凭证管理 — 添加(OAuth 授权)、启用/禁用/删除凭证,批量操作,导入/导出
- 配额监控 — 查看各凭证的订阅等级(Free/Pro/Ultra)与模型配额
- 配置管理 — 在线修改运行时配置
- 调用日志 — 查看 API 调用记录与统计数据
FastAPI + Uvicorn | httpx | aiosqlite | Google OAuth 2.0 (PKCE) | Docker
本项目采用 Cooperative Non-Commercial License (CNC-1.0) 开源,仅允许非商业用途。分发、修改或基于本项目产生的派生作品需继续使用相同或实质相似的非商业许可证,并保留原始版权、许可证和署名声明。
感谢 su-kaka/gcli2api 项目,本项目有参考该项目的思路和实现编写。
- 项目性质:本项目属于纯个人实验性/玩具项目,全量代码由 AI 辅助生成。
- 使用风险:本项目涉及对非官方/特定客户端接口的反向代理及凭证池管理,使用本项目存在极高的账号被封禁(Ban)风险。作者不对任何因使用本项目导致的账号受限、资产损失或服务中断负责。
- 安全提示:本项目的防风控与安全策略并不完善,严禁将其部署于任何生产环境、商业项目或对稳定性要求较高的场景。
- 后果自负:请在遵守相关服务商服务条款(ToS)的前提下进行技术研究。任何因使用本项目而产生的法律责任及后果,均由使用者自行承担。