你是否试过 Google Gemini 的网页版,却被它的封闭生态卡住——无法接入自己的笔记工具、本地 IDE 或开源聊天客户端?gemini-web2api 正是为此而生:它不依赖任何官方 SDK 或 API 密钥,仅用一个纯 Python 脚本,就能将 Gemini 网页界面“镜像”为标准的 OpenAI 风格 API 服务。无论你是想在 Cherry Studio 里直接选 Gemini 模型,还是让 Obsidian 插件调用多轮思考能力,甚至让本地 LLM 工具链无缝切换模型后端——它都能一键打通。
核心功能
- 开箱即用,零认证门槛:默认无需 API Key,启动即用;如需权限控制,只需在 config.json 中配置任意字符串即可启用 Bearer 认证
- 真·OpenAI 兼容:完整支持
/v1/chat/completions和/v1/models接口,现有所有 OpenAI 客户端(如 Cursor、TypingMind、ChatBox)可零修改接入 - 深度思考 + 网络搜索双加持:支持 Gemini 原生的联网搜索能力,并通过
@think=N后缀精细调节推理深度(0=最深入,4=最轻量),兼顾速度与质量 - 全系模型自由切换:内置 gemini-3.5-flash、flash-thinking(支持超长 20k+ 字输出)、pro、auto、lite 等多版本,按需选择不踩坑
- 生产级流式响应:原生支持 Server-Sent Events(SSE)流式传输,对话体验丝滑,适合构建实时交互应用
- 双协议扩展支持:额外提供
/v1/responses(适配 OpenAI Codex)和/v1beta/models(兼容 Gemini CLI 工具),一鱼两吃
适合哪些人用
如果你是开发者,正为本地 LLM 应用寻找免费、稳定、免注册的 Gemini 后端;如果你是效率极客,希望在 Obsidian、Logseq 或自建知识库中调用 Gemini 进行文献摘要或代码解释;如果你是教育工作者或学生,需要在无网络限制的实验室环境里快速部署一个类 ChatGPT 的教学接口;或者你只是普通用户,厌倦了反复登录网页、复制粘贴答案——那么这个单文件、无依赖、跨平台的工具,就是为你量身定制的“Gemini 解锁器”。
快速上手
只需三步,10 秒启动服务:
- 前往 GitHub 项目页 下载
gemini_web2api.py(或用curl -O https://raw.githubusercontent.com/Sophomoresty/gemini-web2api/main/gemini_web2api.py直接获取) - 终端执行:
python gemini_web2api.py(Python 3.8+,无需安装任何第三方包) - 服务自动运行在
http://localhost:8081/v1,在 Cherry Studio、ChatBox 等客户端中将 Base URL 设为此地址,模型名填gemini-3.5-flash-thinking即可开始使用
进阶用户可编辑同目录下的 config.json 自定义 API Key、启用日志、调整超时等参数——全部配置项均有中文注释,开箱即懂。
项目信息
Convert Google Gemini web into OpenAI-compatible API. Zero auth, cross-platform, single file.
513
Stars
170
Forks
Python
MIT
编程语言:Python|GitHub Star 数:513|开源协议:MIT|GitHub 项目地址
它不是模拟器,不是代理层,而是对 Gemini Web 界面的智能桥接——轻、快、稳、全开源,真正把大厂 AI 能力交还给用户自己掌控。



