gemini-web2api教程：一个Python文件把Gemini免费网页版变成OpenAI兼容API

一个Python单文件，把Google Gemini的免费网页版变成OpenAI兼容的API服务器。零认证、零成本、跨平台。

这是什么？

gemini-web2api是一个Python反向代理，它把Google Gemini的网页界面转换成标准的OpenAI API格式（/v1/chat/completions）。这意味着你可以用任何支持OpenAI API的工具——Open WebUI、Continue、Cursor、LobeChat等——直接调用Gemini模型，而且完全免费。

项目只有一个Python文件，1500多星。

为什么需要这个？

Google的Gemini API有免费额度，但需要注册Google Cloud账号、设置计费、获取API密钥。而Gemini的网页版（gemini.google.com）是完全免费的，不需要任何配置。这个工具就是把网页版的免费能力”桥接”成标准API，让你的其他工具也能用上。

安装和使用

第一步：克隆项目

git clone https://github.com/Sophomoresty/gemini-web2api.git
cd gemini-web2api
pip install -r requirements.txt

第二步：匿名模式启动

python gemini_web2api.py

启动后，你就有了一个OpenAI兼容的API服务器，默认监听本地端口。
注意事项：匿名模式下，请求gemini-3.1-pro实际上会被路由到Flash版本（较轻量的模型）。如果需要真正的Pro模型，需要认证模式。
第三步：认证模式（可选，获取Pro模型）
1. 用浏览器登录 gemini.google.com
2. 使用浏览器插件（如Cookie导出工具）导出Cookie到cookie.txt
3. 启动时指定Cookie文件：
python gemini_web2api.py --cookie-file cookie.txt

可能还需要从Gemini页面源码中获取XSRF令牌（SNlM0e），写入config.json中。具体配置参见项目中的config.example.json。
接入你的工具
启动后，在任何支持OpenAI API的工具中配置：

API Base URL：http://localhost:端口号/v1
API Key：随便填（留空也行）
Model：gemini-3.1-pro 或 gemini-3.1-flash

这样你的Open WebUI、Cursor、Continue等工具就能免费调用Gemini了。
使用场景

免费AI API：开发测试阶段，不想花钱买API额度
工具集成：把Gemini接入各种需要OpenAI API格式的工具
原型开发：快速测试应用，不用配置Google Cloud
自托管AI栈：搭配本地UI工具，搭建完全私有的AI助手

注意事项

这个项目依赖逆向工程Google的网页接口，Google随时可能更改接口导致工具失效
Cookie认证需要定期刷新
匿名模式下Pro模型会降级为Flash
仅建议用于个人开发测试，不建议用于生产环境

本文参考来源：GitHub - Sophomoresty/gemini-web2api