零成本调用Gemini大模型:Python脚本实现网页端转OpenAI兼容API

想要免费使用Google Gemini大模型API，又受限于官方API配额与收费？借助开源工具 gemini-web2api，仅用简单Python脚本，就能将Gemini网页端转为标准OpenAI兼容接口，无需申请官方密钥、无需付费，普通谷歌账号即可快速上手，本文整理全套实用干货。

一、工具核心简介

gemini-web2api 是一款纯Python实现的桥接工具，核心作用是逆向适配Gemini网页端协议，对外提供OpenAI格式API服务。

1. 运行环境：仅使用Python标准库，零第三方依赖，无需安装Flask、Requests等框架；

2. 认证方式：全程无需Google API Key、OAuth授权，普通访问无需任何密钥；

3. 适配能力：所有兼容OpenAI接口的客户端、工具、脚本都可直接对接使用。

二、快速部署：三行命令启动服务

部署流程极简，终端执行以下命令即可完成搭建：

git clone https://github.com/Sophomoresty/gemini-web2api

cd gemini-web2api

python gemini_web2api.py

服务默认本地监听地址：http://localhost:8081/v1，完全对标OpenAI原生API地址。

三、代码调用示例

基于OpenAI SDK即可发起请求，api_key 可随意填写，无校验限制：

from openai import OpenAI

# 连接本地转换后的API服务

client = OpenAI(

    base_url="http://localhost:8081/v1",

    api_key="sk-anything"  # 任意字符均可

)

# 发起对话请求

resp = client.chat.completions.create(

    model="gemini-3.5-flash-thinking",

    messages=[{"role": "user", "content": "解释量子计算"}]

)

四、可用模型与参数配置

工具内置6款Gemini模型，适配不同使用场景，同时支持自定义思考深度：

1. 全模型清单

• gemini-3.5-flash：通用高速模型，单轮输出约1.2万字

• gemini-3.5-flash-thinking：深度推理模型，输出超2万字

• gemini-3.5-flash-thinking-lite：自适应推理强度

• gemini-3.1-pro：专业版模型（必须配置Cookie）

• gemini-auto：自动匹配最优模型

• gemini-flash-lite：轻量极简模型，响应最快

2. 推理深度调节

针对深度思考模型，可通过后缀参数控制思考强度：

• gemini-3.5-flash-thinking@think=0：最深思考（默认）

• gemini-3.5-flash-thinking@think=2：中等思考

• gemini-3.5-flash-thinking@think=4：浅层思考

3. 拓展功能

支持Function Calling工具调用、SSE流式输出、Gemini原生联网搜索，同时兼容Codex CLI、Gemini CLI相关接口。

五、解锁Pro模型：仅需网页Cookie

专业版模型无需谷歌付费订阅，免费谷歌账号+网页Cookie即可使用，配置步骤：

1. 打开Chrome浏览器，登录 gemini.google.com；

2. 按下F12打开开发者工具，进入 Application 栏目，找到 Cookies；

3. 复制SID、HSID、SSID等6项Cookie值；

4. 将内容粘贴到项目目录下的 cookie.txt 文件中，重启服务即可。

六、运行原理

工具采用协议转换架构，整体流程清晰：

用户代码（OpenAI格式请求）→ 本地gemini-web2api服务 → 转换为Gemini网页端协议 → 谷歌服务器处理请求 → 结果回传并转回OpenAI格式 → 反馈给用户。

项目仅约2000行代码，单文件部署，架构轻量高效。

七、适用人群

1. 独立开发者：用免费大模型API完成产品原型、功能验证；

2. AI工具爱好者：在ChatBox、Cherry Studio等客户端免费用Gemini；

3. 自动化/代理脚本使用者：对接OpenAI格式接口，规避API收费；

4. Gemini CLI用户：绕过官方API调用配额限制。

八、注意事项（使用边界）

1. 暂不支持图片、多模态输入（Gemini图片上传采用私有RPC协议，无法适配）；

2. 无原生多轮对话，多轮交互需手动拼接历史消息模拟；

3. 短时间高频调用，可能触发谷歌平台限流；

4. 未配置有效Cookie时，调用Pro模型会自动降级为Flash模型。

总结

gemini-web2api 用极简的Python代码打通了Gemini网页端与标准API的壁垒，实现零成本、零门槛调用主流大模型。对于预算有限、仅做测试和日常使用的用户而言，是替代付费API的优质方案。合理遵守平台规则、控制调用频率，就能稳定体验Gemini的全系列能力。