将 GeminiCLI 转换为 OpenAI 和 GEMINI API 接口
English | 中文
本项目采用 Cooperative Non-Commercial License (CNC-1.0)
这是一个反商业化的严格开源协议,详情请查看 LICENSE 文件。
- 个人学习、研究、教育用途
- 非营利组织使用
- 开源项目集成(需遵循相同协议)
- 学术研究和论文发表
- 任何形式的商业使用
- 年收入超过100万美元的企业使用
- 风投支持或公开交易的公司使用
- 提供付费服务或产品
- 商业竞争用途
控制面板演示网址: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-progemini-2.5-pro-preview-06-05gemini-2.5-pro-preview-05-06
gemini-2.5-pro-maxthinking:最大思考预算模式gemini-2.5-pro-nothinking:无思考模式- 支持自定义思考预算配置
- 自动分离思维内容和最终回答
gemini-2.5-pro-search:集成搜索功能的模型
- 假流式模式:在任何模型名称后添加
-假流式后缀- 例:
gemini-2.5-pro-假流式 - 用于需要流式响应但服务端不支持真流式的场景
- 例:
- 流式抗截断模式:在模型名称前添加
流式抗截断/前缀- 例:
流式抗截断/gemini-2.5-pro - 自动检测响应截断并重试,确保完整回答
- 例:
- 系统自动识别模型名称中的功能标识
- 透明地处理功能模式转换
- 支持功能组合使用
初始安装
curl -o termux-install.sh "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/termux-install.sh" && chmod +x termux-install.sh && ./termux-install.sh
重启服务
cd gcli2api
bash termux-start.sh初始安装
iex (iwr "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/install.ps1" -UseBasicParsing).Content
重启服务
双击执行 start.bat
初始安装
curl -o install.sh "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/install.sh" && chmod +x install.sh && ./install.sh
重启服务
cd gcli2api
bash start.sh初始安装
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
重启服务
cd gcli2api
bash start.shDocker 运行命令
# 使用通用密码 docker run -d --name gcli2api --network host -e PASSWORD=pwd -e PORT=7861 -v $(pwd)/data/creds:/app/creds ghcr.io/su-kaka/gcli2api:latest # 使用分离密码 docker run -d --name gcli2api --network host -e API_PASSWORD=api_pwd -e PANEL_PASSWORD=panel_pwd -e PORT=7861 -v $(pwd)/data/creds:/app/creds ghcr.io/su-kaka/gcli2api:latest
Docker Compose 运行命令
- 将以下内容保存为
docker-compose.yml文件:version: '3.8' services: gcli2api: image: ghcr.io/su-kaka/gcli2api:latest container_name: gcli2api restart: unless-stopped network_mode: host environment: # 使用通用密码(推荐用于简单部署) - PASSWORD=pwd - PORT=7861 # 或使用分离密码(推荐用于生产环境) # - API_PASSWORD=your_api_password # - PANEL_PASSWORD=your_panel_password volumes: - ./data/creds:/app/creds healthcheck: test: ["CMD-SHELL", "python -c \"import sys, urllib.request, os; port = os.environ.get('PORT', '7861'); req = urllib.request.Request(f'http://localhost:{port}/v1/models', headers={'Authorization': 'Bearer ' + os.environ.get('PASSWORD', 'pwd')}); sys.exit(0 if urllib.request.urlopen(req, timeout=5).getcode() == 200 else 1)\""] interval: 30s timeout: 10s retries: 3 start_period: 40s
- 启动服务:
docker-compose up -d
- 当前 OAuth 验证流程仅支持本地主机(localhost)访问,即须通过
http://127.0.0.1:7861/auth完成认证(默认端口 7861,可通过 PORT 环境变量修改)。 - 如需在云服务器或其他远程环境部署,请先在本地运行服务并完成 OAuth 验证,获得生成的 json 凭证文件(位于
./geminicli/creds目录)后,再在auth面板将该文件上传即可。 - 请严格遵守使用限制,仅用于个人学习和非商业用途
- 访问
http://127.0.0.1:7861/auth(默认端口,可通过 PORT 环境变量修改) - 完成 OAuth 认证流程(默认密码:
pwd,可通过环境变量修改) - 配置客户端:
OpenAI 兼容客户端:
- 端点地址:
http://127.0.0.1:7861/v1 - API 密钥:
pwd(默认值,可通过 API_PASSWORD 或 PASSWORD 环境变量修改)
Gemini 原生客户端:
- 端点地址:
http://127.0.0.1:7861 - 认证方式:
Authorization: Bearer your_api_passwordx-goog-api-key: your_api_password- URL 参数:
?key=your_api_password
gcli2api 支持多种存储后端,按优先级自动选择:Redis > Postgres > MongoDB > 本地文件
步骤 1: 配置 Redis 连接
# 本地 Redis export REDIS_URI="redis://localhost:6379" # 带密码的 Redis export REDIS_URI="redis://:password@localhost:6379" # SSL 连接(推荐生产环境) export REDIS_URI="rediss://default:password@host:6380" # Upstash Redis(免费云服务) export REDIS_URI="rediss://default:token@your-host.upstash.io:6379" # 可选:自定义数据库索引(默认: 0) export REDIS_DATABASE="1"
步骤 2: 启动应用
# 应用会自动检测 Redis 配置并优先使用 Redis 存储
python web.py如果未配置 Redis,或者你希望使用关系型数据库作为主要存储方案,gcli2api 也支持 Postgres(位于 Redis 之后,优先于 MongoDB)。
⚙️ 启用 Postgres 模式
步骤 1: 配置 Postgres 连接
# 使用标准 DSN(示例) export POSTGRES_DSN="postgresql://user:password@localhost:5432/gcli2api" # 也可以使用 socket 或其他 DSN 格式,取决于你的部署方式
步骤 2: 启动应用
# 应用会自动检测 POSTGRES_DSN 并在 Redis 未启用时优先使用 Postgres 存储
python web.py如果未配置 Redis,gcli2api 将尝试使用 MongoDB 存储模式,
步骤 1: 配置 MongoDB 连接
# 本地 MongoDB export MONGODB_URI="mongodb://localhost:27017" # MongoDB Atlas 云服务 export MONGODB_URI="mongodb+srv://username:password@cluster.mongodb.net" # 带认证的 MongoDB export MONGODB_URI="mongodb://admin:password@localhost:27017/admin" # 可选:自定义数据库名称(默认: gcli2api) export MONGODB_DATABASE="my_gcli_db"
步骤 2: 启动应用
# 应用会自动检测 MongoDB 配置并使用 MongoDB 存储
python web.pyDocker 环境使用 MongoDB
# 单机 MongoDB 部署 docker run -d --name gcli2api \ -e MONGODB_URI="mongodb://mongodb:27017" \ -e API_PASSWORD=your_password \ --network your_network \ ghcr.io/su-kaka/gcli2api:latest # 使用 MongoDB Atlas docker run -d --name gcli2api \ -e MONGODB_URI="mongodb+srv://user:pass@cluster.mongodb.net/gcli2api" \ -e API_PASSWORD=your_password \ -p 7861:7861 \ ghcr.io/su-kaka/gcli2api:latest
Docker Compose 示例
version: '3.8' services: mongodb: image: mongo:7 container_name: gcli2api-mongodb restart: unless-stopped environment: MONGO_INITDB_ROOT_USERNAME: admin MONGO_INITDB_ROOT_PASSWORD: password123 volumes: - mongodb_data:/data/db ports: - "27017:27017" gcli2api: image: ghcr.io/su-kaka/gcli2api:latest container_name: gcli2api restart: unless-stopped depends_on: - mongodb environment: - MONGODB_URI=mongodb://admin:password123@mongodb:27017/admin - MONGODB_DATABASE=gcli2api - API_PASSWORD=your_api_password - PORT=7861 ports: - "7861:7861" volumes: mongodb_data:
MongoDB 连接优化
# 连接池和超时配置 export MONGODB_URI="mongodb://localhost:27017?maxPoolSize=10&serverSelectionTimeoutMS=5000" # 副本集配置 export MONGODB_URI="mongodb://host1:27017,host2:27017,host3:27017/gcli2api?replicaSet=myReplicaSet" # 读写分离配置 export MONGODB_URI="mongodb://localhost:27017/gcli2api?readPreference=secondaryPreferred"
认证和凭证管理 (src/auth.py, src/credential_manager.py)
- OAuth 2.0 认证流程管理
- 多凭证文件状态管理和轮换
- 自动故障检测和恢复
- JWT 令牌生成和验证
API 路由和转换 (src/openai_router.py, src/gemini_router.py, src/openai_transfer.py)
- OpenAI 和 Gemini 格式双向转换
- 多模态输入处理(文本+图像)
- 思维链内容分离和处理
- 流式响应管理
网络和代理 (src/httpx_client.py, src/google_chat_api.py)
- 统一 HTTP 客户端管理
- 代理配置和热更新支持
- 超时和重试策略
- 异步请求池管理
状态管理 (src/state_manager.py, src/usage_stats.py)
- 原子化状态操作
- 使用统计和配额管理
- 文件锁和并发安全
- 数据持久化(TOML 格式)
任务管理 (src/task_manager.py)
- 全局异步任务生命周期管理
- 资源清理和内存管理
- 优雅关闭和异常处理
Web 控制台 (src/web_routes.py)
- RESTful API 端点
- WebSocket 实时通信
- 移动端适配检测
- 批量操作支持
流式抗截断机制 (src/anti_truncation.py)
- 检测响应截断模式
- 自动重试和状态恢复
- 上下文连接管理
格式检测和转换 (src/format_detector.py)
- 自动检测请求格式(OpenAI vs Gemini)
- 无缝格式转换
- 参数映射和验证
用户代理模拟 (src/utils.py)
- GeminiCLI 格式用户代理生成
- 平台检测和客户端元数据
- API 兼容性保证
基础配置
PORT: 服务端口(默认:7861)HOST: 服务器监听地址(默认:0.0.0.0)
密码配置
API_PASSWORD: 聊天 API 访问密码(默认:继承 PASSWORD 或 pwd)PANEL_PASSWORD: 控制面板访问密码(默认:继承 PASSWORD 或 pwd)PASSWORD: 通用密码,设置后覆盖上述两个(默认:pwd)
性能和稳定性配置
CALLS_PER_ROTATION: 每个凭证轮换前的调用次数(默认:10)RETRY_429_ENABLED: 启用 429 错误自动重试(默认:true)RETRY_429_MAX_RETRIES: 429 错误最大重试次数(默认:3)RETRY_429_INTERVAL: 429 错误重试间隔,秒(默认:1.0)ANTI_TRUNCATION_MAX_ATTEMPTS: 抗截断最大重试次数(默认:3)
网络和代理配置
PROXY: HTTP/HTTPS 代理地址(格式:http://host:port)OAUTH_PROXY_URL: OAuth 认证代理端点GOOGLEAPIS_PROXY_URL: Google APIs 代理端点METADATA_SERVICE_URL: 元数据服务代理端点
自动化配置
AUTO_BAN: 启用凭证自动封禁(默认:true)AUTO_LOAD_ENV_CREDS: 启动时自动加载环境变量凭证(默认:false)
兼容性配置
COMPATIBILITY_MODE: 启用兼容性模式,将 system 消息转为 user 消息(默认:false)
日志配置
LOG_LEVEL: 日志级别(DEBUG/INFO/WARNING/ERROR,默认:INFO)LOG_FILE: 日志文件路径(默认:gcli2api.log)
存储配置(按优先级)
Redis 配置(最高优先级)
REDIS_URI: Redis 连接字符串(设置后启用 Redis 模式)- 本地:
redis://localhost:6379 - 带密码:
redis://:password@host:6379 - SSL:
rediss://default:password@host:6380
- 本地:
REDIS_DATABASE: Redis 数据库索引(0-15,默认:0)
MongoDB 配置(第二优先级)
MONGODB_URI: MongoDB 连接字符串(设置后启用 MongoDB 模式)MONGODB_DATABASE: MongoDB 数据库名称(默认:gcli2api)
凭证配置
支持使用 GCLI_CREDS_* 环境变量导入多个凭证:
方式 1:编号格式
export GCLI_CREDS_1='{"client_id":"your-client-id","client_secret":"your-secret","refresh_token":"your-token","token_uri":"https://oauth2.googleapis.com/token","project_id":"your-project"}' export GCLI_CREDS_2='{"client_id":"...","project_id":"..."}'
方式 2:项目名格式
export GCLI_CREDS_myproject='{"client_id":"...","project_id":"myproject",...}' export GCLI_CREDS_project2='{"client_id":"...","project_id":"project2",...}'
启用自动加载
export AUTO_LOAD_ENV_CREDS=true # 程序启动时自动导入环境变量凭证
Docker 使用示例
# 使用通用密码 docker run -d --name gcli2api \ -e PASSWORD=mypassword \ -e PORT=8080 \ -e GOOGLE_CREDENTIALS="$(cat credential.json | base64 -w 0)" \ ghcr.io/su-kaka/gcli2api:latest # 使用分离密码 docker run -d --name gcli2api \ -e API_PASSWORD=my_api_password \ -e PANEL_PASSWORD=my_panel_password \ -e PORT=8080 \ -e GOOGLE_CREDENTIALS="$(cat credential.json | base64 -w 0)" \ ghcr.io/su-kaka/gcli2api:latest
注意:当设置了凭证环境变量时,系统将优先使用环境变量中的凭证,忽略 creds 目录中的文件。
本服务支持两套完整的 API 端点:
端点: /v1/chat/completions
认证: Authorization: Bearer your_api_password
支持两种请求格式,会自动检测并处理:
OpenAI 格式:
{
"model": "gemini-2.5-pro",
"messages": [
{"role": "system", "content": "You are a helpful assistant"},
{"role": "user", "content": "Hello"}
],
"temperature": 0.7,
"stream": true
}Gemini 原生格式:
{
"model": "gemini-2.5-pro",
"contents": [
{"role": "user", "parts": [{"text": "Hello"}]}
],
"systemInstruction": {"parts": [{"text": "You are a helpful assistant"}]},
"generationConfig": {
"temperature": 0.7
}
}非流式端点: /v1/models/{model}:generateContent
流式端点: /v1/models/{model}:streamGenerateContent
模型列表: /v1/models
认证方式(任选一种):
Authorization: Bearer your_api_passwordx-goog-api-key: your_api_password- URL 参数:
?key=your_api_password
请求示例:
# 使用 x-goog-api-key 头部 curl -X POST "http://127.0.0.1:7861/v1/models/gemini-2.5-pro:generateContent" \ -H "x-goog-api-key: your_api_password" \ -H "Content-Type: application/json" \ -d '{ "contents": [ {"role": "user", "parts": [{"text": "Hello"}]} ] }' # 使用 URL 参数 curl -X POST "http://127.0.0.1:7861/v1/models/gemini-2.5-pro:streamGenerateContent?key=your_api_password" \ -H "Content-Type: application/json" \ -d '{ "contents": [ {"role": "user", "parts": [{"text": "Hello"}]} ] }'
Gemini 原生banana:
from io import BytesIO from PIL import Image from google.genai import Client from google.genai.types import HttpOptions from google.genai import types # The client gets the API key from the environment variable `GEMINI_API_KEY`. client = Client( api_key="pwd", http_options=HttpOptions(base_url="http://127.0.0.1:7861"), ) prompt = ( """ 画一只猫 """ ) response = client.models.generate_content( model="gemini-2.5-flash-image", contents=[prompt], config=types.GenerateContentConfig( image_config=types.ImageConfig( aspect_ratio="16:9", ) ) ) for part in response.candidates[0].content.parts: if part.text is not None: print(part.text) elif part.inline_data is not None: image = Image.open(BytesIO(part.inline_data.data)) image.save("generated_image.png")
说明:
- OpenAI 端点返回 OpenAI 兼容格式
- Gemini 端点返回 Gemini 原生格式
- 两种端点使用相同的 API 密码
认证端点
POST /auth/login- 用户登录POST /auth/start- 开始 OAuth 认证POST /auth/callback- 处理 OAuth 回调GET /auth/status/{project_id}- 检查认证状态
凭证管理端点
GET /creds/status- 获取所有凭证状态POST /creds/action- 单个凭证操作(启用/禁用/删除)POST /creds/batch-action- 批量凭证操作POST /auth/upload- 批量上传凭证文件(支持 ZIP)GET /creds/download/{filename}- 下载凭证文件GET /creds/download-all- 打包下载所有凭证POST /creds/fetch-email/{filename}- 获取用户邮箱POST /creds/refresh-all-emails- 批量刷新用户邮箱
配置管理端点
GET /config/get- 获取当前配置POST /config/save- 保存配置
环境变量凭证端点
POST /auth/load-env-creds- 加载环境变量凭证DELETE /auth/env-creds- 清除环境变量凭证GET /auth/env-creds-status- 获取环境变量凭证状态
日志管理端点
POST /auth/logs/clear- 清空日志GET /auth/logs/download- 下载日志文件WebSocket /auth/logs/stream- 实时日志流
使用统计端点
GET /usage/stats- 获取使用统计GET /usage/aggregated- 获取聚合统计POST /usage/update-limits- 更新使用限制POST /usage/reset- 重置使用统计
多模态支持
{
"model": "gemini-2.5-pro",
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "描述这张图片"},
{
"type": "image_url",
"image_url": {
"url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABA..."
}
}
]
}
]
}思维模式支持
{
"model": "gemini-2.5-pro-maxthinking",
"messages": [
{"role": "user", "content": "复杂数学问题"}
]
}响应将包含分离的思维内容:
{
"choices": [{
"message": {
"role": "assistant",
"content": "最终答案",
"reasoning_content": "详细的思考过程..."
}
}]
}流式抗截断使用
{
"model": "流式抗截断/gemini-2.5-pro",
"messages": [
{"role": "user", "content": "写一篇长文章"}
],
"stream": true
}兼容性模式
# 启用兼容性模式 export COMPATIBILITY_MODE=true
此模式下,所有 system 消息会转换为 user 消息,提高与某些客户端的兼容性。
如果这个项目对您有帮助,欢迎支持项目的持续发展!
详细捐赠信息请查看:📖 捐赠说明文档
本项目仅供学习和研究用途。使用本项目表示您同意:
- 不将本项目用于任何商业用途
- 承担使用本项目的所有风险和责任
- 遵守相关的服务条款和法律法规
项目作者对因使用本项目而产生的任何直接或间接损失不承担责任。