文章总结： gemini-web2api项目将GoogleGemini网页版封装成OpenAI兼容API，无需付费订阅或APIKey即可匿名使用。支持多个Gemini模型包括3.5FlashThinking（最长2万字输出），可通过@think参数控制思考深度。部署简单，支持Python直接运行，提供Cookie配置获取Pro模型。适用于脚本开发、实验测试等非生产环境，实现免费使用Gemini能力。 综合评分： 85 文章分类： 安全开发,技术标准,解决方案

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

原创

v3n0m v3n0m

v3n0m

2026年6月2日 22:32 天津

在小说阅读器读本章

去阅读

前几天部署的ds2api不用用了被，这两天注意到一个类似的叫gemini-web2api的项目。 项目地址：https://github.com/Sophomoresty/gemini-web2api

#

它做的事情一句话就能说清楚：把 Google Gemini 网页版封装成 OpenAI 兼容的 API。

你不需要办 Gemini 的付费订阅，也不需要申请 API Key，匿名就可以用。但如果需要更高级的模型，就需要谷歌账号了。它把 Gemini 的模型包装成了 OpenAI 的接口格式，现有的 ChatGPT 客户端、代码工具直接改个地址就能用。

它能干什么

装好之后，你可以在任何支持 OpenAI API 的地方使用 Gemini 模型：

• 支持Cherry Studio、ChatBox 等桌面客户端
• 自己的 Python 脚本调用sdk
• 使用OpenAI Codex CLI
• 甚至配合Gemini CLI用原生接口

支持的模型也不少：

| | | | — | — | | 模型 | 说明 | | gemini-3.5-flash | 快速通用，约 1.2 万字输出 | | gemini-3.5-flash-thinking | 深度思考模式，最长 2 万字输出 | | gemini-3.5-flash-thinking-lite | 自适应思考深度 | | gemini-3.1-pro | Pro 模型（需要 cookie） | | gemini-auto | 自动选择 | | gemini-flash-lite | 轻量快速 |

另外还有一个很实用的功能：通过 @think=N 后缀控制思考深度，@think=0 最深，@think=4 最浅，根据需要调节。

部署方式可以使用 Python 直接运行

我本机安装了 uv，所以直接用 uv 安装依赖：

uv add -r requirements.txt

因为上 Google 需要某种科学手段，所以一定要开代理。我使用的是 Clash：

uv run python -m gemini_web2api --proxy http://127.0.0.1:7897

启动成功后进行简单的测试：

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\":\"你好\"}]}"

收到回复就表示成功了。

可选：配置 Cookie 获取 Pro 模型

如果你想要真正的 Pro 模型路由（默认匿名访问时 Pro 会降级到 Flash），需要提供 Gemini 网页版的 Cookie：

1. 打开 Chrome，登录 gemini.google.com
2. F12 → Application → Cookies → https://gemini.google.com
3. 复制这几个值：SID、HSID、SSID、APISID、SAPISID、__Secure-1PSID
4. 创建 cookie.txt：

然后在 config.json 里设置重启即可。

在 Python 里调用OpenAI SDK：

from openai import OpenAIclient = OpenAI(    base_url="http://localhost:8081/v1",    api_key="sk-gemini")resp = client.chat.completions.create(    model="gemini-3.5-flash-thinking",    messages=[{"role": "user", "content": "用中文解释什么是 RAG"}])print(resp.choices[0].message.content)

我的感受

从功能上说，gemini-web2api 是个很聪明的项目。它没有逆向复杂的协议，而是直接复用了 Gemini 网页版的接口，把已经免费开放的东西包装成标准 API。纯 Python、零依赖、部署简单这三个特点让它非常实用。

对于日常写脚本、做实验、跑一些自动化任务来说，免费的 Gemini 通过这个中转已经够用了。而且 Gemini 3.5 Flash Thinking 的长输出能力（2 万字）是很多免费模型做不到的。

当然，生产环境还是建议用官方的 API。但如果你跟我一样，喜欢折腾、想白嫖一下 Gemini 的能力，这个项目值得试一试。

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：v3n0m v3n0m v3n0m《Gemini 免费版秒变 API：gemini-web2api 部署全记录》