GeminiCLI to API

当前，许多工具和框架（如 LangChain、LlamaIndex、ComfyUI）默认使用 OpenAI API 格式，但 Google 的 Gemini 原生 API 采用 contents 结构，两者不兼容。若想在现有系统中无缝接入 Gemini，通常需大量代码适配。

GeminiCLI to API 解决了这一痛点：它是一个高性能、高可用的 API 代理服务，同时暴露 OpenAI 兼容端点与 Gemini 原生端点，并自动检测与转换请求格式，让开发者无需修改一行代码即可调用 Gemini。

双协议支持：一套服务，两种格式

✅ OpenAI 兼容端点

• 路径：/v1/chat/completions、/v1/models
• 格式：标准 messages 结构（role: system/user/assistant）
• 自动处理：
  • 将 system 消息转换为 user（Gemini 不支持 system）
  • 支持多模态输入（文本 + 图像 URL/base64）
  • 流式响应（stream: true）完全兼容

✅ Gemini 原生端点

• 路径：/v1/models/{model}:generateContent、streamGenerateContent
• 格式：contents + parts 结构
• 完整支持 Gemini 官方 API 规范，包括 Safety Settings、Generation Config 等

自动格式检测：系统根据请求体结构（messages vs contents）或路径自动识别格式，无需手动切换。

高可用凭证管理：1000+ 请求不中断

每个 Google OAuth 凭证默认享有 1000 次/天的 gemini-2.5-pro 调用额度。为突破单凭证限制，GeminiCLI to API 提供企业级凭证管理系统：

🔁 多凭证自动轮换

• 支持批量导入 ZIP 凭证文件（client_secret_xxx.json）
• 自动检测凭证状态（有效/429/403/500）
• 负载均衡：按调用次数或健康状态分配请求
• 自动封禁：连续失败后临时禁用凭证，避免浪费配额

📊 配额与统计

• 按凭证统计调用次数（支持 UTC+7 日粒度）
• 聚合显示总可用额度
• 支持设置自定义每日限制，防止超额

支持 GCLI_CREDS_ 环境变量*（Base64 编码），Docker 部署友好。

高级模型功能支持

所有模型均支持 1M token 上下文窗口，并提供以下专用变体：

系统自动解析模型名称中的前缀/后缀，透明启用对应功能，支持组合使用（如 流式抗截断/gemini-2.5-pro-假流式）。

生产级稳定性与监控

⚙️ 网络与重试

• 支持 HTTP/HTTPS 代理（可分别配置 OAuth、Google API、元数据服务代理）
• 429 自动重试：可配置重试间隔（如 60s）与最大次数
• 异步任务超时管理，防止请求堆积

📈 实时监控

• WebSocket 日志流：在 Web 控制台实时查看请求/响应
• 凭证健康状态面板（绿色/黄色/红色）
• API 调用成功率、错误码分布统计

🔐 安全与认证

• 双密码体系：
  • API 密码（用于 /v1/chat/completions）
  • 控制台密码（用于 Web 管理界面）
• 多认证方式：
  • Authorization: Bearer <token>
  • x-goog-api-key: xxx
  • URL 参数 ?key=xxx
• 控制台支持 JWT 令牌认证，自动显示绑定的 Google 邮箱

全功能 Web 控制台

• 凭证文件上传/下载/批量操作（启用、禁用、删除）
• 实时日志查看（支持过滤、下载、清空）
• 系统配置热更新（部分项无需重启）
• 移动端适配，随时随地管理服务