Amm1rr GitHub avatar

WebAI-to-API

Python
网页聊天转 API 工具Amm1rr最近推送 2026年11月1日
模型推理与部署MIT1,41023621 issues7 天 +5

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日

把浏览器里的 Gemini 网页服务包装成 OpenAI 兼容 API,供本地调用。

这是一个 Python 项目,通过浏览器原生运行时(Playwright)或 Gemini WebAPI 后端访问网页版 Gemini,并对外暴露 OpenAI 风格的 /v1/chat/completions 接口。它采用按提供商划分的架构和统一路由,支持流式响应、会话续接、健康检查与运行时诊断,并提供 Docker 部署和网页仪表盘。

推荐指数

3.0

适合想用 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. 第 1 步

    安装依赖

    安装脚本创建配置与运行状态,安装 Python 依赖和 Playwright Chromium。

  2. 第 2 步

    配置后端

    在 config.conf 中选择 Gemini 的 webapi 或 playwright 后端及默认模型。

  3. 第 3 步

    完成认证

    通过 verify_login.py 走浏览器登录,或为 WebAPI 配置 cookies。

  4. 第 4 步

    启动服务

    运行 src/run.py,在 6969 端口提供 API、仪表盘和 Swagger 文档。

  5. 第 5 步

    转发请求

    收到 OpenAI 格式请求后,按模型路由到对应后端执行并返回结果。

快速上手

  1. 1

    克隆并安装

    克隆仓库后运行对应平台的安装脚本。

    git clone https://github.com/Amm1rr/WebAI-to-API.git && cd WebAI-to-API && ./install.sh
  2. 2

    配置

    检查生成的 config.conf,设置 Gemini 后端和默认模型。

  3. 3

    认证

    运行登录脚本完成浏览器认证。

    poetry run python verify_login.py
  4. 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 也不保留文本与文件的精确交错顺序。

主题标签

aiapifastapifreegoogle-bard-apipythonwebserverwebservicechatbotbardgeminigemini-apillmuvicornchatgpt