Skip to content

Repository files navigation

ACLI2API

License: CNC-1.0

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.py

Docker 部署

docker compose up -d

自定义配置:

ACLI2API_PASSWORD=your-api-key ACLI2API_PANEL_PASSWORD=your-panel-pwd docker compose up -d

服务默认监听 17342 端口,管理面板访问 http://localhost:17342/

API 端点

端点 方法 格式 说明
/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)的前提下进行技术研究。任何因使用本项目而产生的法律责任及后果,均由使用者自行承担。

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages