gcli2api Gemini CLI to API

将 GeminiCLI 转换为 OpenAI 和 GEMINI API 接口

控制面板演示网址：https://gcli2api-9xbf.onrender.com 密码：pwd
Github开源：https://github.com/su-kaka/gcli2api

gcli2api 核心功能

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

认证和安全管理

灵活的密码管理
分离密码支持：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 认证流程管理
凭证文件上传、下载、管理
实时日志查看（WebSocket）
系统配置管理
使用统计和监控面板
移动端适配界面

批量操作支持
ZIP 文件批量上传凭证
批量启用/禁用/删除凭证
批量获取用户邮箱
批量配置管理

使用统计和监控

详细使用统计
按凭证文件统计调用次数
Gemini 2.5 Pro 模型专项统计
每日配额管理（UTC+7 重置）
聚合统计和分析
自定义每日限制配置

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

高级配置和自定义

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

性能和稳定性配置
429 错误自动重试（可配置间隔和次数）
抗截断最大重试次数
凭证轮换策略
并发请求管理

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

环境变量和配置管理

灵活的配置方式
TOML 配置文件支持
环境变量配置
热配置更新（部分配置项）
配置锁定（环境变量优先级）

环境变量凭证支持
GCLI_CREDS_* 格式环境变量导入
自动加载环境变量凭证
Base64 编码凭证支持
Docker 容器友好

支持的模型

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

基础模型

gemini-2.5-pro
gemini-2.5-pro-preview-06-05
gemini-2.5-pro-preview-05-06

思维模型（Thinking Models）

gemini-2.5-pro-maxthinking：最大思考预算模式
gemini-2.5-pro-nothinking：无思考模式
支持自定义思考预算配置
自动分离思维内容和最终回答

搜索增强模型

gemini-2.5-pro-search：集成搜索功能的模型

特殊功能变体

假流式模式：在任何模型名称后添加 -假流式 后缀
例：gemini-2.5-pro-假流式
用于需要流式响应但服务端不支持真流式的场景
流式抗截断模式：在模型名称前添加 流式抗截断/ 前缀
例：流式抗截断/gemini-2.5-pro
自动检测响应截断并重试，确保完整回答

模型功能自动检测

系统自动识别模型名称中的功能标识
透明地处理功能模式转换
支持功能组合使用