GeminiCLI 转 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 实时日志流
• 系统状态监控
• 凭证健康状态

🔧 高级配置和自定义

网络和代理配置

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

性能和稳定性配置

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

日志和调试

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

🔄 环境变量和配置管理

灵活的配置方式

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

支持的模型

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

🤖 基础模型

• gemini-2.5-pro
• gemini-3-pro-preview
• gemini-3.1-pro-preview

🧠 思维模型（Thinking Models）

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

🔍 搜索增强模型

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

🖼️ 图像生成模型（Antigravity）

• gemini-3.1-flash-image：基础图像生成模型
• 分辨率后缀：
  • -2k：2K 分辨率
  • -4k：4K 高清分辨率
• 比例后缀：
  • -1x1：正方形（头像）
  • -16x9：横屏（电脑壁纸）
  • -9x16：竖屏（手机壁纸）
  • -21x9：超宽屏（带鱼屏）
  • -4x3：传统显示器
  • -3x4：竖版海报
• 组合使用示例：
  • gemini-3.1-flash-image-4k-16x9：4K 横屏
  • gemini-3.1-flash-image-2k-9x16：2K 竖屏
• 不指定比例时，API 自动决定横竖比例

🌊 特殊功能变体

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

🔧 模型功能自动检测

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

---

安装指南

Termux 环境

初始安装

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

Windows 环境

初始安装

iex (iwr "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/install.ps1" -UseBasicParsing).Content

重启服务 双击执行 start.bat

Linux 环境

初始安装

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

macOS 环境

初始安装

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.sh

Docker 环境

Docker 运行命令

# 使用通用密码
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 Mac

# 使用通用密码
docker run -d \
  --name gcli2api \
  -p 7861:7861 \
  -p 8080:8080 \
  -e PASSWORD=pwd \
  -e PORT=7861 \
  -v "$(pwd)/data/creds":/app/creds \
  ghcr.io/su-kaka/gcli2api:latest

# 使用分离密码
docker run -d \
--name gcli2api \
-p 7861:7861 \
-p 8080:8080 \
-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 运行命令

1. 将以下内容保存为 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
   

2. 启动服务：

   docker-compose up -d
   

---

配置说明

1. 访问 http://127.0.0.1:7861 （默认端口，可通过 PORT 环境变量修改）
2. 完成 OAuth 认证流程（默认密码：pwd，可通过环境变量修改）
   • GCLI 模式：用于获取 Google Cloud Gemini API 凭证
   • Antigravity 模式：用于获取 Google Antigravity API 凭证
3. 配置客户端：

OpenAI 兼容客户端：

• 端点地址：http://127.0.0.1:7861/v1
• API 密钥：pwd（默认值，可通过 API_PASSWORD 或 PASSWORD 环境变量修改）

Gemini 原生客户端：

• 端点地址：http://127.0.0.1:7861
• 认证方式：
  • Authorization: Bearer your_api_password
  • x-goog-api-key: your_api_password
  • URL 参数：?key=your_api_password

🌟 双认证模式支持

GCLI 认证模式

• 标准的 Google Cloud Gemini API 认证
• 支持 OAuth2.0 认证流程
• 自动启用必需的 Google Cloud API

Antigravity 认证模式

• Google Antigravity API 专用认证
• 独立的凭证管理系统
• 支持批量上传和管理
• 与 GCLI 凭证完全隔离

统一管理界面

• 在"批量上传"标签页中可一次性管理两种凭证
• 上半部分：GCLI 凭证批量上传（蓝色主题）
• 下半部分：Antigravity 凭证批量上传（绿色主题）
• 各自独立的凭证管理标签页

💾 数据存储模式

🌟 存储后端支持

gcli2api 支持两种存储后端：本地 SQLite（默认） 和 MongoDB（云端分布式存储）

📁 本地 SQLite 存储（默认）

默认存储方式

• 无需配置，开箱即用
• 数据存储在本地 SQLite 数据库中
• 适合单机部署和个人使用
• 自动创建和管理数据库文件

🍃 MongoDB 云端存储模式

云端分布式存储方案

当需要多实例部署或云端存储时，可以启用 MongoDB 存储模式。

⚙️ 启用 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.py

Docker 环境使用 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"

环境变量配置

基础配置

• PORT: 服务端口（默认：7861）
• HOST: 服务器监听地址（默认：0.0.0.0）

密码配置

• API_PASSWORD: 聊天 API 访问密码（默认：继承 PASSWORD 或 pwd）
• PANEL_PASSWORD: 控制面板访问密码（默认：继承 PASSWORD 或 pwd）
• PASSWORD: 通用密码，设置后覆盖上述两个（默认：pwd）

性能和稳定性配置

• 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: 日志文件路径（默认：log.txt）

存储配置

SQLite 配置（默认）

• 无需配置，自动使用本地 SQLite 数据库
• 数据库文件自动创建在项目目录

MongoDB 配置（可选云端存储）

• MONGODB_URI: MongoDB 连接字符串（设置后启用 MongoDB 模式）
• MONGODB_DATABASE: MongoDB 数据库名称（默认：gcli2api）

Docker 使用示例

# 使用通用密码
docker run -d --name gcli2api \
  -e PASSWORD=mypassword \
  -e PORT=7861 \
  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=7861 \
  ghcr.io/su-kaka/gcli2api:latest

注意：当设置了凭证环境变量时，系统将优先使用环境变量中的凭证，忽略 creds 目录中的文件。

API 使用方式

本服务支持三套完整的 API 端点：

1. OpenAI 兼容端点（GCLI）

端点： /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
  }
}

2. Gemini 原生端点（GCLI）

非流式端点： /v1/models/{model}:generateContent 流式端点： /v1/models/{model}:streamGenerateContent 模型列表： /v1/models

认证方式（任选一种）：

• Authorization: Bearer your_api_password
• x-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"}]}
    ]
  }'

3. Claude API 格式端点

端点： /v1/messages 认证： x-api-key: your_api_password 或 Authorization: Bearer your_api_password

请求示例：

curl -X POST "http://127.0.0.1:7861/v1/messages" \
  -H "x-api-key: your_api_password" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-pro",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

支持 system 参数：

{
  "model": "gemini-2.5-pro",
  "max_tokens": 1024,
  "system": "You are a helpful assistant",
  "messages": [
    {"role": "user", "content": "Hello"}
  ]
}

说明：

• 完全兼容 Claude API 格式规范
• 自动转换为 Gemini 格式调用后端
• 支持 Claude 的所有标准参数
• 响应格式符合 Claude API 规范

4. Antigravity API 端点

支持三种格式：OpenAI、Gemini 和 Claude

Antigravity OpenAI 格式端点

端点： /antigravity/v1/chat/completions 认证： Authorization: Bearer your_api_password

请求示例：

curl -X POST "http://127.0.0.1:7861/antigravity/v1/chat/completions" \
  -H "Authorization: Bearer your_api_password" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      {"role": "user", "content": "Hello"}
    ],
    "stream": true
  }'

Antigravity Gemini 格式端点

非流式端点： /antigravity/v1/models/{model}:generateContent 流式端点： /antigravity/v1/models/{model}:streamGenerateContent

认证方式（任选一种）：

• Authorization: Bearer your_api_password
• x-goog-api-key: your_api_password
• URL 参数：?key=your_api_password

请求示例：

# Gemini 格式非流式请求
curl -X POST "http://127.0.0.1:7861/antigravity/v1/models/claude-sonnet-4-5:generateContent" \
  -H "x-goog-api-key: your_api_password" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "Hello"}]}
    ],
    "generationConfig": {
      "temperature": 0.7
    }
  }'

# Gemini 格式流式请求
curl -X POST "http://127.0.0.1:7861/antigravity/v1/models/gemini-2.5-flash:streamGenerateContent?key=your_api_password" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "Hello"}]}
    ]
  }'

Antigravity Claude 格式端点

端点： /antigravity/v1/messages 认证： x-api-key: your_api_password

请求示例：

curl -X POST "http://127.0.0.1:7861/antigravity/v1/messages" \
  -H "x-api-key: your_api_password" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello"}
    ]
  }'

支持的 Antigravity 模型：

• Claude 系列：claude-sonnet-4-5、claude-opus-4-5 等
• Gemini 系列：gemini-2.5-flash、gemini-2.5-pro 等
• 自动支持思维模型（thinking models）

Gemini 原生示例：

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-3.1-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 密码

📋 完整 API 参考

Web 控制台 API

认证端点

• POST /auth/login - 用户登录
• POST /auth/start - 开始 OAuth 认证（支持 GCLI 和 Antigravity 模式）
• POST /auth/callback - 处理 OAuth 回调
• POST /auth/callback-url - 从回调 URL 直接完成认证
• GET /auth/status/{project_id} - 检查认证状态

凭证管理端点（支持 mode=geminicli 或 mode=antigravity 参数）

• POST /creds/upload - 批量上传凭证文件（支持 JSON 和 ZIP）
• GET /creds/status - 获取凭证状态列表（支持分页和筛选）
• GET /creds/detail/{filename} - 获取单个凭证详情
• POST /creds/action - 单个凭证操作（启用/禁用/删除）
• POST /creds/batch-action - 批量凭证操作
• GET /creds/download/{filename} - 下载单个凭证文件
• GET /creds/download-all - 打包下载所有凭证
• POST /creds/fetch-email/{filename} - 获取用户邮箱
• POST /creds/refresh-all-emails - 批量刷新用户邮箱
• POST /creds/deduplicate-by-email - 按邮箱去重凭证
• POST /creds/verify-project/{filename} - 检验凭证 Project ID
• GET /creds/quota/{filename} - 获取凭证额度信息（仅 Antigravity）

配置管理端点

• GET /config/get - 获取当前配置
• POST /config/save - 保存配置

日志管理端点

• POST /logs/clear - 清空日志
• GET /logs/download - 下载日志文件
• WebSocket /logs/stream - 实时日志流

版本信息端点

• GET /version/info - 获取版本信息（可选 check_update=true 参数检查更新）

聊天 API 功能特性

多模态支持

{
  "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 消息，提高与某些客户端的兼容性。

---

💬 交流群

欢迎加入 QQ 群交流讨论！

QQ 群号：937681997

---

许可证与免责声明

本项目仅供学习和研究用途。使用本项目表示您同意：

• 不将本项目用于任何商业用途
• 承担使用本项目的所有风险和责任
• 遵守相关的服务条款和法律法规

项目作者对因使用本项目而产生的任何直接或间接损失不承担责任。

gcli2api 快速上手指南

gcli2api 是一个强大的转换工具，能将 GeminiCLI 和 Antigravity 的凭证转换为兼容 OpenAI、Gemini 原生及 Claude 格式的 API 接口。它支持多模态输入、智能凭证轮换、流式传输抗截断以及 Web 管理控制台。

⚠️ 许可证提示：本项目采用 CNC-1.0 (Cooperative Non-Commercial License) 协议。严禁任何形式的商业使用（包括年收入超 100 万美元的企业、风投支持公司等）。仅限个人学习、研究、教育及非营利组织使用。

1. 环境准备

系统要求

• 操作系统：Linux, macOS, Windows, 或 Android (Termux)
• Python 版本：3.12 或更高版本
• 网络环境：需能访问 Google 服务（若在国内，建议配置代理）

前置依赖

• Docker (可选)：推荐使用 Docker 部署，可避免环境配置问题。
• 代理配置 (国内用户)：如果无法直接连接 Google，请在启动时设置 PROXY 环境变量。

2. 安装步骤

您可以选择 Docker 部署（推荐）或 本地脚本部署。

方案 A：Docker 部署（推荐）

最简单的方式是使用 Docker，无需安装 Python 环境。

运行命令：

# 基础运行（使用默认密码 'pwd'）
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 PASSWORD=pwd \
  -e PORT=7861 \
  -e PROXY=http://host.docker.internal:7890 \
  -v $(pwd)/data/creds:/app/creds \
  ghcr.io/su-kaka/gcli2api:latest

注：将 http://host.docker.internal:7890 替换为您实际的代理地址。

使用 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
      # - PROXY=http://192.168.1.5:7890 # 如需代理请取消注释并修改
    volumes:
      - ./data/creds:/app/creds

启动服务：

docker-compose up -d

方案 B：本地脚本部署

Linux / macOS

# 一键安装
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

Windows (PowerShell)

# 一键安装
iex (iwr "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/install.ps1" -UseBasicParsing).Content

# 启动服务
# 双击运行生成的 start.bat 文件

Termux (Android)

# 一键安装
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

3. 基本使用

第一步：获取凭证

1. 访问管理面板：http://127.0.0.1:7861 (端口可通过 PORT 变量修改)。
2. 输入密码登录（默认密码：pwd，可通过 PASSWORD 环境变量修改）。
3. 在面板中选择 GCLI 模式 或 Antigravity 模式 完成 OAuth 认证。
   • 认证成功后，凭证会自动保存并轮换。
   • 支持批量上传 ZIP 格式的凭证文件。

第二步：配置客户端

gcli2api 自动兼容多种 API 格式，您可以根据习惯选择任意一种方式调用。

方式 1：OpenAI 兼容格式（最常用）

适用于 Chatbox, NextChat, OneAPI 等支持 OpenAI 标准的客户端。

• Base URL: http://127.0.0.1:7861/v1
• API Key: pwd (或您设置的 API_PASSWORD)
• 模型名称: gemini-2.5-pro, gemini-2.5-pro-high 等

Python 调用示例：

from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:7861/v1",
    api_key="pwd" 
)

response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[
        {"role": "system", "content": "你是一个助手"},
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

方式 2：Gemini 原生格式

适用于需要直接使用 Gemini 原生结构的场景。

• Base URL: http://127.0.0.1:7861
• 认证: Header Authorization: Bearer pwd 或 URL 参数 ?key=pwd
• 端点: /v1/models/{model}:generateContent

方式 3：Claude 兼容格式

• Base URL: http://127.0.0.1:7861/v1
• 端点: /v1/messages
• 模型: 支持映射到后端的 Gemini 模型。

高级功能速览

• 思维模型：使用 gemini-2.5-pro-high 开启深度思考模式，系统会自动分离思考过程与最终回答。
• 图像生成：使用 Antigravity 凭证，调用如 gemini-3.1-flash-image-4k-16x9 等模型。
• 流式抗截断：在模型名前加前缀，如 流式抗截断/gemini-2.5-pro，防止长回答被切断。
• 假流式模式：在模型名后加后缀，如 gemini-2.5-pro-假流式，强制模拟流式输出。

常用环境变量配置

变量名	说明	默认值
PORT	服务监听端口	7861
PASSWORD	通用访问密码	pwd
API_PASSWORD	API 接口专用密码	同 PASSWORD
PANEL_PASSWORD	管理面板专用密码	同 PASSWORD
PROXY	HTTP/HTTPS 代理地址	无
LOG_LEVEL	日志级别 (DEBUG/INFO...)	INFO
MONGODB_URI	MongoDB 连接串 (启用云端存储)	无 (默认 SQLite)