告别API限制！gcli2api：免费Gemini 2.5 Pro的完美平替方案

• Gemini免费层收紧，2.5 Pro无法使用

• 个人用户/开发者面临的困境

• 商业API的高成本门槛

Gemini 免费层级收紧后，Gemini 2.5 Pro 不让用了，不得已又用上 GeminiCLI to API，本地运行一把成功，授权也给搞成两步无脑模式，简直不要太方便，实测也能跑通，这玩意儿拿来给小号耍耍倒还行。

控制面板演示网址：https://gcli2api-9xbf.onrender.com 密码：pwd

多端点双格式支持

• 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 界面

• 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-3-pro-preview

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

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

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

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

开源地址

Github 地址：https://github.com/su-kaka/gcli2api

本地运行

本地Mac打开终端，运行： curl -o darwin-install.sh "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/darwin-install.sh" && chmod +x darwin-install.sh && ./darwin-install.sh 安装后，给到web管理地址和默认密码：pwd 获取认证后，在配置管理可获取相关api/接口以及修改密码等操作。 配合DeepChat，即可连接对话使用：