Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/su-kaka/gcli2api

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

GeminiCLI to API

Name: gcli2api
Author: su-kaka

将 GeminiCLI 和 Antigravity 转换为 OpenAI 、GEMINI 和 Claude API 兼容接口

English | 中文 | 日本語

🚀 快速部署

安装指南

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 运行命令

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

核心功能

🔄 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
自动检测响应截断并重试，确保完整回答

🔧 模型功能自动检测

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

配置说明

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

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:

Frequently Asked Questions

What is gcli2api?⌄

gcli2api is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by su-kaka. 将 GeminiCLI 和 Antigravity 转换为 OpenAI 、GEMINI 和 Claude API 接口. It has 5,083 GitHub stars.

Is gcli2api safe to use?⌄

Yes. gcli2api passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install gcli2api?⌄

Clone the repository with "git clone https://github.com/su-kaka/gcli2api" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is gcli2api written in?⌄

gcli2api is primarily written in Python. It is open-source under su-kaka on GitHub, so you can review or fork the full source.

Are there alternatives to gcli2api?⌄

Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh gcli2api against similar tools.

gcli2api

Installation

Getting Started

Security Report

README.md

GeminiCLI to API

🚀 快速部署

安装指南

Termux 环境

Windows 环境

Linux 环境

macOS 环境

Docker 环境

核心功能

🔄 API 端点和格式支持

🔐 认证和安全管理

📊 智能凭证管理系统

🌊 流式传输和响应处理

🎛️ Web 管理控制台

📈 使用监控

🔧 高级配置和自定义

🔄 环境变量和配置管理

支持的模型

🤖 基础模型

🧠 思维模型（Thinking Models）

🔍 搜索增强模型

🖼️ 图像生成模型（Antigravity）

🌊 特殊功能变体

🔧 模型功能自动检测

配置说明

🌟 双认证模式支持

💾 数据存储模式

🌟 存储后端支持

📁 本地 SQLite 存储（默认）

🍃 MongoDB 云端存储模式

⚙️ 启用 MongoDB 模式

🔧 高级配置

环境变量配置

Frequently Asked Questions

Comments (0)

Related Skills

Developers Also Liked