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-pro | Pro 模型(需要 Cookie) |
| gemini-auto | 自动选择 |
| gemini-flash-lite | 轻量快速 |
特色功能: 通过 @think=N 后缀控制思考深度(@think=0 最深,@think=4 最浅)
💡 优点
- 纯 Python、零依赖、部署简单 — 代码简洁,易于理解和修改
- 免费白嫖 — 无需 API Key,匿名即可使用 Gemini 基础模型
- OpenAI 兼容 — 所有支持 OpenAI API 的工具都能直接用(Cherry Studio、ChatBox、Python SDK、OpenAI Codex CLI、Gemini CLI 等)
- 长输出能力 — Gemini 3.5 Flash Thinking 支持 2 万字输出,超过很多免费模型
- 不逆向复杂协议 — 直接复用 Gemini 网页版接口,思路巧妙
- 灵活控制 — @think=N 后缀可按需调节思考深度
⚠️ 缺点
- 匿名使用受限 — Pro 模型需要登录 Google 账号提供 Cookie
- 生产环境不建议 — 作者建议生产环境使用官方 API
- 依赖网页接口 — 如果 Google 更改网页版接口结构,项目可能需要更新
- 需要科学上网 — 访问 Gemini 需要代理环境
🛠️ 操作方法
1. 安装依赖(需要 Python 环境,推荐 uv)
uv add -r requirements.txt2. 启动服务(需要开代理,以 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-web2api | GitHub 项目主页 |
| https://gemini.google.com | Google Gemini 网页版(获取 Cookie 用) |
📝 个人评价
非常实用的"白嫖"工具,适合日常写脚本、做实验、跑自动化任务。部署简单到令人发指,如果你已经有代理环境,几分钟就能跑起来。生产环境建议走官方 API,但个人使用完全够了。
- 分类:开源项目
- 浏览量:14