将 GeminiCLI 转换为 OpenAI 和 GEMINI API 接口

English | 中文

本项目采用 Cooperative Non-Commercial License (CNC-1.0)

这是一个反商业化的严格开源协议，详情请查看 LICENSE 文件。

• 个人学习、研究、教育用途
• 非营利组织使用
• 开源项目集成（需遵循相同协议）
• 学术研究和论文发表

• 任何形式的商业使用
• 年收入超过100万美元的企业使用
• 风投支持或公开交易的公司使用
• 提供付费服务或产品
• 商业竞争用途

多端点双格式支持

• 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 账户邮箱地址

独立的 API Key 管理

• 创建多个独立的 API Key，每个 Key 拥有独立配额
• 不同模型消耗不同次数（Pro: 10次、Flash: 2次、抗截断模式翻倍）
• 实时查询 Key 余额和使用统计
• 细致的模型调用统计（记录每个模型的使用次数）
• 支持无认证查询（用户自查额度）

管理面板

• 管理端: /api-key-admin - 创建、查看、删除 API Key（需要管理密码）
• 查询端: /api-key-query - 用户自助查询配额（无需密码）

核心 API 端点

• POST /auth/keys - 创建新 Key（需要面板密码）
• GET /auth/keys - 查看所有 Key 状态（需要面板密码）
• GET /auth/quota - 查看当前 Key 配额（使用 API Key 认证）
• POST /auth/query - 查询指定 Key 余额（无需认证，提供 Key 即可）
• GET /auth/models/costs - 查看模型消耗配置
• POST /auth/models/costs - 更新模型消耗配置

无需登录的认证页面

• 访问路径: /auth - 独立的 OAuth 认证界面
• 一键生成 Google OAuth 认证链接
• 支持手动粘贴回调 URL 完成认证（即使网络回调失败）
• 自动保存认证凭证到服务器
• 适合多人协作认证场景

使用场景

• 公益站运营：分享 /auth 链接给朋友们帮忙认证
• 团队协作：多人贡献认证账号
• 临时认证：无需登录控制面板即可完成认证

高级凭证管理

• 多个 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-2.5-pro-preview-06-05
• gemini-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.sh

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

1. 将以下内容保存为 docker-compose.yml 文件：

   version: '3.8'services: gcli2api: image: ghcr.io/su-kaka/gcli2api:latestcontainer_name: gcli2apirestart: unless-stoppednetwork_mode: hostenvironment: # 使用通用密码（推荐用于简单部署） - PASSWORD=pwd - PORT=7861# 或使用分离密码（推荐用于生产环境）# - API_PASSWORD=your_api_password# - PANEL_PASSWORD=your_panel_passwordvolumes: - ./data/creds:/app/credshealthcheck: 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: 30stimeout: 10sretries: 3start_period: 40s

2. 启动服务：

   docker-compose up -d

• 当前 OAuth 验证流程仅支持本地主机（localhost）访问，即须通过 http://127.0.0.1:7861/auth 完成认证（默认端口 7861，可通过 PORT 环境变量修改）。
• 如需在云服务器或其他远程环境部署，请先在本地运行服务并完成 OAuth 验证，获得生成的 json 凭证文件（位于 ./geminicli/creds 目录）后，再在auth面板将该文件上传即可。
• 请严格遵守使用限制，仅用于个人学习和非商业用途

方式一：使用管理密码直接调用（传统方式）

1. 访问 http://127.0.0.1:7861/auth （默认端口，可通过 PORT 环境变量修改）
2. 完成 OAuth 认证流程
3. 配置客户端：
   • 端点地址：http://127.0.0.1:7861/v1
   • API 密钥：pwd（默认值，可通过 API_PASSWORD 或 PASSWORD 环境变量修改）

方式二：使用 API Key 系统（推荐，适合多用户）

1. 认证阶段：访问 /auth 让用户完成 OAuth 认证
2. 管理阶段：访问 /api-key-admin 创建 API Key
   • 使用 PANEL_PASSWORD 登录管理面板
   • 创建不同配额的 Key（例如：1000次、5000次、10000次）
   • 为每个 Key 添加描述（如："Discord用户张三"）
3. 分发阶段：将生成的 API Key 分发给用户
4. 使用阶段：用户使用分配的 API Key 调用服务
   • 端点地址：http://127.0.0.1:7861/v1
   • API 密钥：使用分配的 API Key（格式：sk-xxx...）
5. 查询阶段：用户访问 /api-key-query 查看剩余配额

创建 API Key（管理员）

curl -X POST "http://127.0.0.1:7861/auth/keys" \ -H "Authorization: Bearer your_panel_password" \ -H "Content-Type: application/json" \ -d '{ "total_quota": 1000, "description": "测试用户" }'# 返回示例：#{# "api_key": "sk-AbCdEf123456...",# "total_quota": 1000,# "used_quota": 0,# "remaining_quota": 1000,# "created_at": "2024-01-01T00:00:00",# "description": "测试用户"# }

使用 API Key 调用（用户）

curl -X POST "http://127.0.0.1:7861/v1/chat/completions" \ -H "Authorization: Bearer sk-AbCdEf123456..." \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-2.5-flash", "messages": [{"role": "user", "content": "Hello"}] }'

查询 API Key 余额（用户）

curl -X POST "http://127.0.0.1:7861/auth/query" \ -H "Content-Type: application/json" \ -d '{ "api_key": "sk-AbCdEf123456..." }'# 返回示例：#{# "api_key": "sk-AbCdEf...456",# "total_quota": 1000,# "used_quota": 20,# "remaining_quota": 980,# "usage_percentage": 2.0,# "model_stats":{# "gemini-2.5-flash": 10 # 调用了10次（消耗20配额）# }# }

传统方式（共享密码）：

• 个人使用
• 小团队内部使用
• 信任的用户群体

API Key 方式（独立配额）：

• 公益站运营（多人共享但需要额度控制）
• 社区分发（不同用户不同配额）
• 临时访客（设置较小配额）
• 精细化管理（需要统计每个用户的使用情况）

OpenAI 兼容端点：

• 端点地址：http://127.0.0.1:7861/v1
• 认证方式：Authorization: Bearer <API_PASSWORD 或 API_KEY>

Gemini 原生端点：

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

gcli2api 支持多种存储后端，按优先级自动选择：Redis > Postgres > MongoDB > 本地文件

步骤 1: 配置 Redis 连接

# 本地 Redisexport REDIS_URI="redis://localhost:6379"# 带密码的 Redisexport REDIS_URI="redis://:password@localhost:6379"# SSL 连接（推荐生产环境）export REDIS_URI="rediss://default:password@host:6380"# Upstash Redis（免费云服务）export REDIS_URI="rediss://default:[email protected]: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 连接

# 本地 MongoDBexport MONGODB_URI="mongodb://localhost:27017"# MongoDB Atlas 云服务export MONGODB_URI="mongodb+srv://username:[email protected]"# 带认证的 MongoDBexport 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:[email protected]/gcli2api" \ -e API_PASSWORD=your_password \ -p 7861:7861 \ ghcr.io/su-kaka/gcli2api:latest

Docker Compose 示例

version: '3.8'services: mongodb: image: mongo:7container_name: gcli2api-mongodbrestart: unless-stoppedenvironment: MONGO_INITDB_ROOT_USERNAME: adminMONGO_INITDB_ROOT_PASSWORD: password123volumes: - mongodb_data:/data/dbports: - "27017:27017"gcli2api: image: ghcr.io/su-kaka/gcli2api:latestcontainer_name: gcli2apirestart: unless-stoppeddepends_on: - mongodbenvironment: - MONGODB_URI=mongodb://admin:password123@mongodb:27017/admin - MONGODB_DATABASE=gcli2api - API_PASSWORD=your_api_password - PORT=7861ports: - "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）
  • 用于调用 /v1/chat/completions 等聊天端点
  • 也可以使用 API Key 代替此密码
• PANEL_PASSWORD: 控制面板访问密码（默认：继承 PASSWORD 或 pwd）
  • 用于登录控制面板和创建 API Key
• 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_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"}]} ] }'

Gemini 原生banana：

fromioimportBytesIOfromPILimportImagefromgoogle.genaiimportClientfromgoogle.genai.typesimportHttpOptionsfromgoogle.genaiimporttypes# 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", ) ) ) forpartinresponse.candidates[0].content.parts: ifpart.textisnotNone: print(part.text) elifpart.inline_dataisnotNone: 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 回调
• POST /auth/callback-url - 从回调 URL 直接完成认证（无需登录）
• GET /auth/status/{project_id} - 检查认证状态

API Key 管理端点（🆕 新功能）

• POST /auth/keys - 创建新的 API Key（需要面板密码）
• GET /auth/keys - 列出所有 API Key 及使用情况（需要面板密码）
• GET /auth/keys/{api_key} - 查看特定 Key 的详细信息（需要面板密码）
• DELETE /auth/keys/{api_key} - 删除指定的 API Key（需要面板密码）
• GET /auth/quota - 查看当前 Key 的配额（使用 API Key 认证）
• POST /auth/query - 查询 API Key 使用情况（无需认证，提供 Key 即可）
• GET /auth/models/costs - 列出所有模型的消耗配置
• POST /auth/models/costs - 更新模型的消耗配置
• DELETE /auth/models/costs/{model_name} - 删除模型消耗配置
• GET /auth/models/{model_name}/cost - 查询特定模型的消耗次数（公开接口）

凭证管理端点

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

欢迎加入 QQ 群交流讨论！

QQ 群号：937681997

如果这个项目对您有帮助，欢迎支持项目的持续发展！

详细捐赠信息请查看：📖 捐赠说明文档

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

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

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