Gemini 免费版秒变 API — gemini-web2api 部署全记录

这是GitHub上的一个开源项目,可把Google Gemini 网页版封装成 OpenAI 兼容的 API供本地调用

📌 项目概述

把 Google Gemini 网页版封装成 OpenAI 兼容的 API,免费使用 Gemini 模型,无需付费订阅,无需申请 API Key。

  • 将 Gemini 模型包装成 OpenAI 标准接口格式
  • 现有 ChatGPT 客户端、代码工具直接改地址就能用
  • 支持匿名使用(基础模型),登录 Google 账号可解锁 Pro 模型

✅ 支持的模型

模型说明
gemini-3.5-flash快速通用,约 1.2 万字输出
gemini-3.5-flash-thinking深度思考模式,最长 2 万字输出
gemini-3.5-flash-thinking-lite自适应思考深度
gemini-3.1-proPro 模型(需要 Cookie)
gemini-auto自动选择
gemini-flash-lite轻量快速

特色功能: 通过 @think=N 后缀控制思考深度(@think=0 最深,@think=4 最浅)


💡 优点

  1. 纯 Python、零依赖、部署简单 — 代码简洁,易于理解和修改
  2. 免费白嫖 — 无需 API Key,匿名即可使用 Gemini 基础模型
  3. OpenAI 兼容 — 所有支持 OpenAI API 的工具都能直接用(Cherry Studio、ChatBox、Python SDK、OpenAI Codex CLI、Gemini CLI 等)
  4. 长输出能力 — Gemini 3.5 Flash Thinking 支持 2 万字输出,超过很多免费模型
  5. 不逆向复杂协议 — 直接复用 Gemini 网页版接口,思路巧妙
  6. 灵活控制 — @think=N 后缀可按需调节思考深度

⚠️ 缺点

  1. 匿名使用受限 — Pro 模型需要登录 Google 账号提供 Cookie
  2. 生产环境不建议 — 作者建议生产环境使用官方 API
  3. 依赖网页接口 — 如果 Google 更改网页版接口结构,项目可能需要更新
  4. 需要科学上网 — 访问 Gemini 需要代理环境

🛠️ 操作方法

1. 安装依赖(需要 Python 环境,推荐 uv)
uv add -r requirements.txt
2. 启动服务(需要开代理,以 Clash 为例)
uv run python -m gemini_web2api --proxy http://127.0.0.1:7897

默认监听地址:http://127.0.0.1:8081/v1

3. 测试
curl http://127.0.0.1:8081/v1/chat/completions \  -H "Content-Type: application/json" \  -H "Authorization: Bearer ***" \  -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"你好"}]}'
4. Python SDK 调用
from openai import OpenAIclient = OpenAI(base_url="http://localhost:8081/v1", api_key="***")resp = client.chat.completions.create(    model="gemini-3.5-flash-thinking",    messages=[{"role":"user","content":"用中文解释什么是 RAG"}])print(resp.choices[0].message.content)
5. 配置 Cookie 获取 Pro 模型(可选)
  • 打开 Chrome,登录 gemini.google.com
  • F12 → Application → Cookies → 复制以下值:SID、HSID、SSID、APISID、SAPISID、__Secure-1PSID
  • 创建 cookie.txt,在 config.json 中设置,重启即可

🧪 测试方法

  • 启动服务后,用 curl 发送请求到 /v1/chat/completions,收到回复即表示成功
  • 可切换不同模型(flash、thinking、pro)分别测试
  • 使用 @think=N 后缀测试不同思考深度效果
  • 用 Python SDK 长文本输出测试(验证 2 万字能力)

🔗 相关链接

链接说明
https://github.com/Sophomoresty/gemini-web2apiGitHub 项目主页
https://gemini.google.comGoogle Gemini 网页版(获取 Cookie 用)

📝 个人评价

非常实用的"白嫖"工具,适合日常写脚本、做实验、跑自动化任务。部署简单到令人发指,如果你已经有代理环境,几分钟就能跑起来。生产环境建议走官方 API,但个人使用完全够了。