AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日
把浏览器里的 Gemini 网页服务包装成 OpenAI 兼容 API,供本地调用。
这是一个 Python 项目,通过浏览器原生运行时(Playwright)或 Gemini WebAPI 后端访问网页版 Gemini,并对外暴露 OpenAI 风格的 /v1/chat/completions 接口。它采用按提供商划分的架构和统一路由,支持流式响应、会话续接、健康检查与运行时诊断,并提供 Docker 部署和网页仪表盘。
推荐指数
适合想用 OpenAI 接口调用网页版 Gemini 的开发者,但依赖浏览器登录态,且自身不提供调用方鉴权。
近 7 天
+5
新增 Star
总 Star 排名
#2830
雷达追踪的 3,958 个 AI 仓库中
创建于
2023
2023年7月23日
核心亮点
1OpenAI 兼容接口
提供 /v1/chat/completions,可直接接入现有 OpenAI SDK 或客户端。
2双后端路由
Gemini 可选 webapi 或 playwright 后端,模型名前缀可强制指定路由。
3流式与会话
支持 SSE 流式响应和会话续接,另有客户端自管历史的无状态接口。
4自带仪表盘
/ui 提供运行状态、认证查看、模型发现、调试场和会话管理。
5部署方式齐全
提供安装/更新脚本和 Docker Compose 部署。
适用场景
本地接入现有工具
例如:把已支持 OpenAI 接口的聊天客户端指向 http://localhost:6969/v1 使用 Gemini。
自管历史的无状态调用
例如:客户端每次请求都重发全部历史,调用 /v1/stateless/chat/completions。
快速验证与调试
例如:打开 /ui 仪表盘查看认证状态,并在调试场里发消息测试模型。
它是怎么工作的
第 1 步
安装依赖
安装脚本创建配置与运行状态,安装 Python 依赖和 Playwright Chromium。
第 2 步
配置后端
在 config.conf 中选择 Gemini 的 webapi 或 playwright 后端及默认模型。
第 3 步
完成认证
通过 verify_login.py 走浏览器登录,或为 WebAPI 配置 cookies。
第 4 步
启动服务
运行 src/run.py,在 6969 端口提供 API、仪表盘和 Swagger 文档。
第 5 步
转发请求
收到 OpenAI 格式请求后,按模型路由到对应后端执行并返回结果。
快速上手
- 1
克隆并安装
克隆仓库后运行对应平台的安装脚本。
git clone https://github.com/Amm1rr/WebAI-to-API.git && cd WebAI-to-API && ./install.sh - 2
配置
检查生成的 config.conf,设置 Gemini 后端和默认模型。
- 3
认证
运行登录脚本完成浏览器认证。
poetry run python verify_login.py - 4
启动并发请求
启动服务后向本地 6969 端口发送聊天请求。
poetry run python src/run.py
适合谁
- 想用 OpenAI 接口调用网页版 Gemini 的开发者
- 需要本地或内网自建 AI 网关的个人和小团队
- 需要流式响应和会话续接的客户端开发者
不太适合
- 需要稳定官方 API 保障的生产系统
- 无法运行浏览器或 Playwright 的环境
- 需要多用户鉴权与配额管理的场景
成熟度
- 活跃度最近一次推送在 2026-11 年,仍在持续维护。
- 文档README 分拆出安装、API、配置、架构、Docker 等多份文档。
- 社区约 1400 star、238 fork,开放 issue 21 个,规模中等。
- 上手难度有安装脚本和仪表盘,但需 Poetry、Playwright 和浏览器登录,步骤偏多。
使用前注意
- · 项目自身不提供调用方 API 鉴权,默认只应绑定 localhost,对外暴露需另加访问控制。
- · 依赖网页版 Gemini 的登录态和页面行为,服务稳定性受上游变动影响。
- · 需要 Python >=3.11,<3.13 和 Poetry,并安装 Playwright Chromium;Windows 对 Python 版本有额外要求。
- · Gemini Playwright 和 Atlas 后端不支持文件内容,WebAPI 也不保留文本与文件的精确交错顺序。
