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用原生接口

支持的模型也不少：

另外还有一个很实用的功能：通过 @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 的能力，这个项目值得试一试。