Spaces:
Running
Running
| title: Antigravity2api | |
| emoji: 🚀 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: docker | |
| pinned: false | |
| license: mit | |
| # Antigravity Gateway | |
| <div align="center"> | |
| <img src="client/public/rocket.svg" width="120" alt="Antigravity Logo" /> | |
| <h3>Google Antigravity API to OpenAI Proxy</h3> | |
| <p> | |
| 将 Google Antigravity API 转换为 OpenAI 兼容格式的高性能网关服务。 | |
| <br /> | |
| 内置现代化管理后台，支持多账号轮询、Token 自动刷新、密钥管理与实时监控。 | |
| </p> | |
| <p> | |
| <a href="https://github.com/liuw1535/antigravity2api-nodejs"> | |
| <img src="https://img.shields.io/badge/原项目-liuw1535/antigravity2api--nodejs-blue?style=flat-square&logo=github" alt="Original Project" /> | |
| </a> | |
| </p> | |
| </div> | |
| > [!NOTE] | |
| > 本项目基于 [liuw1535/antigravity2api-nodejs](https://github.com/liuw1535/antigravity2api-nodejs) 进行开发和优化。 | |
| --- | |
| ## ⚠️ 重要提示 | |
| > [!WARNING] | |
| > **使用风险警告** | |
| > - 本项目仅供学习与技术研究，请勿用于商业用途或违反服务条款的场景 | |
| > - 使用本项目可能违反 Google 服务条款，存在账号被封禁的风险 | |
| > - 请妥善保管 `data/accounts.json` 文件，其中包含敏感的访问凭证 | |
| > - 建议不要将账号数据文件提交到版本控制系统或公开分享 | |
| > - 使用者需自行承担因使用本项目而产生的一切后果 | |
| --- | |
| ## ✨ 功能特性 | |
| ### 核心功能 | |
| - **OpenAI 兼容**: 完全兼容 OpenAI Chat Completions API 格式，无缝对接现有生态。 | |
| - **流式响应**: 支持 SSE (Server-Sent Events) 流式输出，体验流畅。 | |
| - **多模态支持**: 支持文本及 Base64 编码的图片输入 (GPT-4 Vision 兼容)。 | |
| - **工具调用**: 支持 Function Calling，扩展模型能力。 | |
| ### 增强特性 | |
| - **多账号池**: 支持配置多个 Google 账号，自动负载均衡与轮询。 | |
| - **Token 自动保活**: 内置 Token 刷新机制，自动处理过期与 403 错误。 | |
| - **高并发支持**: 优化的请求处理队列，支持高并发场景。 | |
| ### 管理后台 (Dashboard) | |
| - **现代化 UI**: 基于 React + Tailwind CSS 构建的极简主义设计风格。 | |
| - **密钥管理**: 创建、删除、禁用 API Key，支持设置额度与过期时间。 | |
| - **Token 管理**: 可视化管理 Google 账号，实时查看 Token 状态。 | |
| - **系统监控**: 实时监控 CPU、内存、请求数与响应时间。 | |
| - **在线测试**: 内置 Chat 调试界面，方便测试模型效果。 | |
| - **日志审计**: 完整的请求日志记录与查询。 | |
| ## 🛠️ 技术栈 | |
| - **后端**: Node.js (Express), Native Fetch | |
| - **前端**: React, Vite, Tailwind CSS, Framer Motion, Lucide React | |
| - **数据存储**: 本地 JSON 文件存储 (轻量级，无外部数据库依赖) | |
| ## 🚀 快速开始 | |
| ### 环境要求 | |
| - Node.js >= 18.0.0 | |
| ### 1. 安装与构建 | |
| ```bash | |
| # 安装项目依赖 | |
| npm install | |
| # 构建前端资源 | |
| npm run build | |
| ``` | |
| ### 2. 配置服务 | |
| 编辑根目录下的 `config.json` 文件： | |
| ```json | |
| { | |
| "server": { | |
| "port": 8045, // 服务端口 | |
| "host": "0.0.0.0" // 监听地址 | |
| }, | |
| "security": { | |
| "apiKey": "sk-admin", // 管理员/默认 API Key | |
| "maxRequestSize": "50mb" // 最大请求体大小 | |
| }, | |
| "defaults": { | |
| "model": "gemini-2.0-flash-exp" // 默认模型 | |
| } | |
| } | |
| ``` | |
| ### 3. 添加 Google 账号 | |
| 运行 OAuth 登录脚本获取 Access Token： | |
| ```bash | |
| npm run login | |
| ``` | |
| 按提示在浏览器中授权，获取的 Token 将自动保存到 `data/accounts.json`。 | |
| > [!CAUTION] | |
| > **数据安全警告** | |
| > - `data/accounts.json` 文件包含您的 Google 账号访问令牌,具有高度敏感性 | |
| > - 请确保该文件权限设置正确 (建议 chmod 600)，仅所有者可读写 | |
| > - **切勿**将此文件上传到 GitHub、Gitee 等公开代码仓库 | |
| > - **切勿**与他人分享此文件或将其暴露在公网环境 | |
| > - 定期检查 `.gitignore` 文件，确保 `data/` 目录已被排除 | |
| > - 如发现令牌泄露，请立即在 Google 账号设置中撤销相关应用权限 | |
| ### 4. 启动服务 | |
| ```bash | |
| # 生产模式 | |
| npm start | |
| # 开发模式 (支持热重载) | |
| npm run dev | |
| ``` | |
| 服务启动后，访问 `http://localhost:8045` 进入管理后台。 | |
| > [!TIP] | |
| > **首次登录提示** | |
| > - 默认管理密码: `admin123` | |
| > - 登录后请及时在设置页面修改密码以确保安全 | |
| ## 🔌 API 使用指南 | |
| ### 基础 URL | |
| `http://localhost:8045` | |
| ### 认证 | |
| 所有请求需在 Header 中携带 API Key： | |
| `Authorization: Bearer <YOUR_API_KEY>` | |
| ### 1. 获取模型列表 | |
| `GET /v1/models` | |
| ### 2. 聊天补全 | |
| `POST /v1/chat/completions` | |
| **请求示例:** | |
| ```bash | |
| curl http://localhost:8045/v1/chat/completions \ | |
| -H "Content-Type: application/json" \ | |
| -H "Authorization: Bearer sk-admin" \ | |
| -d '{ | |
| "model": "gemini-2.0-flash-exp", | |
| "messages": [{"role": "user", "content": "Hello!"}], | |
| "stream": true | |
| }' | |
| ``` | |
| ## 📂 项目结构 | |
| ``` | |
| . | |
| ├── client/ # 前端 React 项目 | |
| │ ├── src/ | |
| │ │ ├── components/ # UI 组件 | |
| │ │ ├── pages/ # 页面组件 | |
| │ │ └── ... | |
| │ └── ... | |
| ├── data/ # 数据存储目录 | |
| │ ├── accounts.json # Google 账号数据 | |
| │ ├── keys.json # API Key 数据 | |
| │ └── ... | |
| ├── src/ # 后端源码 | |
| │ ├── server/ # 服务器入口 | |
| │ ├── api/ # API 路由处理 | |
| │ ├── auth/ # 认证与 Token 管理 | |
| │ └── ... | |
| ├── scripts/ # 工具脚本 | |
| ├── config.json # 配置文件 | |
| └── package.json | |
| ``` | |
| ## ⚖️ 免责声明 | |
| 本项目 (Antigravity Gateway) 仅供技术学习、研究和交流使用，开发者不对使用本项目产生的任何后果负责。 | |
| ### 使用条款 | |
| 1. **自行承担风险**: 使用者在使用本项目时，需完全理解并接受相关风险，包括但不限于： | |
| - Google 账号被暂停、封禁或限制访问 | |
| - 违反 Google 服务条款可能导致的法律责任 | |
| - 数据泄露、隐私侵犯等安全风险 | |
| - 服务不稳定、数据丢失等技术问题 | |
| 2. **禁止商业用途**: 本项目严禁用于任何商业用途，包括但不限于： | |
| - 提供付费 API 代理服务 | |
| - 作为商业产品的技术组件 | |
| - 任何形式的盈利性活动 | |
| 3. **合规使用**: 使用者需确保： | |
| - 遵守所在地区的法律法规 | |
| - 遵守 Google 及相关服务的使用条款 | |
| - 不利用本项目进行任何违法或侵权行为 | |
| 4. **数据安全**: 使用者应当： | |
| - 妥善保管账号凭证和敏感数据 | |
| - 采取适当的安全措施防止数据泄露 | |
| - 对因疏忽导致的安全问题自行负责 | |
| 5. **无担保声明**: 本项目按 "现状" 提供，不提供任何明示或暗示的担保，包括但不限于： | |
| - 适销性担保 | |
| - 特定用途适用性担保 | |
| - 不侵权担保 | |
| - 服务质量或可靠性担保 | |
| ### 责任限制 | |
| 在任何情况下，本项目的开发者、贡献者及相关方均不对以下情况承担责任： | |
| - 因使用或无法使用本项目而产生的任何直接、间接、偶然、特殊或后果性损害 | |
| - 数据丢失、业务中断、利润损失或其他经济损失 | |
| - 第三方的任何索赔或诉讼 | |
| **使用本项目即表示您已充分理解并接受上述所有条款。如不同意，请勿使用本项目。** | |
| --- | |
| ## 📝 License | |
| MIT License | |
| 本许可证授予的权利和义务不影响上述免责声明的效力。 | |