gemini-web2api

gemini-web2api 是一个轻量级开源工具，旨在将 Google Gemini 网页端的能力无缝转换为标准的 OpenAI 兼容 API。它无需官方 API Key，零认证、零成本，即可让你在任何支持 OpenAI 格式的客户端（如 Cherry Studio、ChatBox、Codex CLI）中免费使用 Gemini 的最新模型，包括强大的 Flash Thinking 和原生联网搜索能力。

核心亮点：免费、兼容、强大

1. OpenAI 完美兼容

• 标准接口：直接替换 /v1/chat/completions 和 /v1/models，无缝接入现有生态。
• Function Calling：完整支持 OpenAI 格式的函数调用，便于构建 Agent。
• 多客户端支持：兼容 Cherry Studio、ChatBox、OpenAI Python SDK 及 Google 原生 Gemini CLI。

2. 解锁 Gemini 高级能力

• Flash Thinking：支持 gemini-3.5-flash-thinking 模型，提供深度推理能力，最长输出可达 2 万字。
• 可调思考深度：通过 @think=N 后缀（0-4）灵活调节思考深度，平衡速度与质量。
• 原生联网搜索：内置 Google 原生搜索能力，获取实时信息，拒绝过时数据。
• 多模型选择：涵盖 Flash、Pro、Auto、Lite 等多种模型，满足不同场景需求。

3. 极简部署，零依赖

• 纯 Python 实现：仅使用标准库，无外部依赖，跨平台运行（Windows/macOS/Linux）。
• 灵活鉴权：支持免密访问或自定义 API Key 校验。
• Cookie 增强：可选配置 Cookie 以解锁 Pro 模型路由及更高配额。

快速开始

1. 启动服务

python gemini_web2api.py

服务默认启动在 http://localhost:8081/v1。

2. 客户端配置

以 Cherry Studio 或 OpenAI SDK 为例：

• Base URL: http://localhost:8081/v1
• API Key: 任意字符串（若 config.json 中 api_keys 为空）或配置的 Key。
• Model: gemini-3.5-flash-thinking

Python SDK 示例：

from openai import OpenAI
client = OpenAI(base_url="http://localhost:8081/v1", api_key="sk-any-key")
resp = client.chat.completions.create(
    model="gemini-3.5-flash-thinking",
    messages=[{"role": "user", "content": "解释量子计算"}]
)
print(resp.choices[0].message.content)

3. 可选：配置 Cookie 解锁 Pro

若需使用真正的 gemini-3.1-pro 路由，需提取浏览器 Cookie：

1. 登录 gemini.google.com。
2. 从开发者工具获取 SID, HSID, SSID, APISID, SAPISID, __Secure-1PSID。
3. 保存为 cookie.txt 或在 config.json 中配置。

高级功能

• 思考深度调节：

  gemini-3.5-flash-thinking@think=0   # 最深思考（默认）
  gemini-3.5-flash-thinking@think=4   # 最浅思考（最快）
  

• 代理支持：支持 HTTP/HTTPS 代理（Clash/V2Ray），解决网络访问问题。
• Docker 部署：提供 Dockerfile 及 Docker Compose 配置，一键容器化运行。

已知限制

• 无多模态输入：暂不支持图片/文件上传（受限于 Gemini Web 专有协议）。
• 单轮对话模拟：多轮上下文通过在 Prompt 中拼接历史消息实现。
• 频率限制：高频请求可能触发 Google 风控，建议合理设置重试间隔。
• Pro 路由限制：无付费 Cookie 时，Pro 模型可能降级为 Flash。