GeminiCLI to API

将 GeminiCLI 和 Antigravity 转换为 OpenAI 、GEMINI 和 Claude API 兼容接口

English | 中文

🚀 快速部署

⚠️ 许可证声明

本项目采用 Cooperative Non-Commercial License (CNC-1.0)

这是一个反商业化的严格开源协议，详情请查看 LICENSE 文件。

✅ 允许的用途：

个人学习、研究、教育用途
非营利组织使用
开源项目集成（需遵循相同协议）
学术研究和论文发表

❌ 禁止的用途：

任何形式的商业使用
年收入超过100万美元的企业使用
风投支持或公开交易的公司使用
提供付费服务或产品
商业竞争用途

核心功能

🔄 API 端点和格式支持

多端点多格式支持

OpenAI 兼容端点：/v1/chat/completions 和 /v1/models
- 支持标准 OpenAI 格式（messages 结构）
- 支持 Gemini 原生格式（contents 结构）
- 自动格式检测和转换，无需手动切换
- 支持多模态输入（文本 + 图像）
Gemini 原生端点：/v1/models/{model}:generateContent 和 streamGenerateContent
- 支持完整的 Gemini 原生 API 规范
- 多种认证方式：Bearer Token、x-goog-api-key 头部、URL 参数 key
Claude 格式兼容：完整支持 Claude API 格式
- 端点：/v1/messages（遵循 Claude API 规范）
- 支持 Claude 标准的 messages 格式
- 支持 system 参数和 Claude 特有功能
- 自动转换为后端支持的格式
Antigravity API 支持：同时支持 OpenAI、Gemini 和 Claude 格式
- OpenAI 格式端点：/antigravity/v1/chat/completions
- Gemini 格式端点：/antigravity/v1/models/{model}:generateContent 和 streamGenerateContent
- Claude 格式端点：/antigravity/v1/messages
- 支持所有 Antigravity 模型（Claude、Gemini 等）
- 自动模型名称映射和思维模式检测

🔐 认证和安全管理

灵活的密码管理

分离密码支持：API 密码（聊天端点）和控制面板密码可独立设置
多种认证方式：支持 Authorization Bearer、x-goog-api-key 头部、URL 参数等
JWT Token 认证：控制面板支持 JWT 令牌认证
用户邮箱获取：自动获取和显示 Google 账户邮箱地址

📊 智能凭证管理系统

高级凭证管理

多个 Google OAuth 凭证自动轮换
通过冗余认证增强稳定性
负载均衡与并发请求支持
自动故障检测和凭证禁用
凭证使用统计和配额管理
支持手动启用/禁用凭证文件
批量凭证文件操作（启用、禁用、删除）

凭证状态监控

实时凭证健康检查
错误码追踪（429、403、500 等）
自动封禁机制（可配置）

🌊 流式传输和响应处理

多种流式支持

真正的实时流式响应
假流式模式（用于兼容性）
流式抗截断功能（防止回答被截断）
异步任务管理和超时处理

响应优化

思维链（Thinking）内容分离
推理过程（reasoning_content）处理
多轮对话上下文管理
兼容性模式（将 system 消息转换为 user 消息）

🎛️ Web 管理控制台

全功能 Web 界面

OAuth 认证流程管理（支持 GCLI 和 Antigravity 双模式）
凭证文件上传、下载、管理
实时日志查看（WebSocket）
系统配置管理
使用统计和监控面板
移动端适配界面

批量操作支持

ZIP 文件批量上传凭证（GCLI 和 Antigravity）
批量启用/禁用/删除凭证
批量获取用户邮箱
批量配置管理
统一批量上传界面管理所有凭证类型

📈 使用监控

实时监控

WebSocket 实时日志流
系统状态监控
凭证健康状态
API 调用成功率统计

🔧 高级配置和自定义

网络和代理配置

HTTP/HTTPS 代理支持
代理端点配置（OAuth、Google APIs、元数据服务）
超时和重试配置
网络错误处理和恢复

性能和稳定性配置

429 错误自动重试（可配置间隔和次数）
抗截断最大重试次数

日志和调试

多级日志系统（DEBUG、INFO、WARNING、ERROR）
日志文件管理
实时日志流
日志下载和清空

🔄 环境变量和配置管理

灵活的配置方式

环境变量配置
热配置更新（部分配置项）
配置锁定（环境变量优先级）

支持的模型

所有模型均具备 1M 上下文窗口容量。每个凭证文件提供 1000 次请求额度。

🤖 基础模型

gemini-2.5-pro
gemini-3-pro-preview

gcli2api