Gemini Web2API：零成本将Gemini网页版转为OpenAI兼容API

📅 2026年05月31日 · 技术

项目简介

对于经常调用大模型 API 的开发者来说，API 费用是一笔不小的开销。gemini-web2api 是一个纯 Python 实现的开源项目，它巧妙地将 Google Gemini 的网页版接口转换成了 OpenAI 兼容的 API 格式，让开发者可以零成本使用 Gemini 的强大能力。

项目目前获得了 523 Star，完全跨平台，零依赖（仅需 Python 标准库），部署极其简单。

核心功能

OpenAI 兼容：完全兼容 /v1/chat/completions 和 /v1/models 端点，可直接替换 OpenAI SDK
零认证成本：不配置 API Key 时无需任何认证，配置后支持 OpenAI 风格的 Bearer 认证
函数调用：完整支持 Tool Calling（OpenAI 格式），可直接用于 Agent 开发
多模型支持：Flash、Flash Thinking（支持 2 万+字符输出）、Pro、Auto、Lite 等多种模型
思考深度可调：通过 @think=N 后缀控制推理深度（0=最深，4=最浅）
联网搜索：内置 Gemini 原生搜索能力
SSE 流式传输：支持 Server-Sent Events 流式响应
Codex CLI 兼容：提供 Responses API 端点，兼容 OpenAI Codex

快速上手

一行命令即可启动服务：

python gemini_web2api.py

服务默认运行在 http://localhost:8081/v1，然后你就可以在 Cherry Studio、ChatBox 等任何 OpenAI 客户端中配置使用，将 Base URL 指向本地地址即可。

对于习惯使用 API 的开发者，也可以用 curl 直接调用：

curl http://localhost:8081/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"Hello!"}]}'

适用场景

这个项目特别适合个人开发者、学习阶段的学生，以及需要频繁调用大模型进行原型验证的场景。它让你可以在不产生 API 费用的情况下，享受到 Gemini 最新模型的强大能力。对于已经使用 OpenAI SDK 的项目，只需修改 Base URL 即可无缝切换。

参考来源

gemini-web2api — GitHub