WebAI-to-API

Q: Windows 上 Python 版本有什么要求？

需 Python 3.11.10+ 或 3.12.4+，用于安全的 Gemini WebAPI 临时 cookie 缓存处理。

Q: install.sh / install.ps1 做了什么？

创建缺失的配置文件和运行时状态，安装项目依赖与 Playwright Chromium，然后运行诊断。

Q: 如何切换 Gemini 后端？

在 config.conf 和 .env 中把 Gemini 后端配置为 webapi 或 playwright。

Q: 是否支持流式输出和连续对话？

支持，提供 SSE 流式响应与对话续接，接口为 OpenAI 兼容的 /v1/chat/completions。

把网页版AI变成API，轻松接入你的应用

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 235 🐛 待处理 21 👀 关注 15

GitHub ↗

GitHub 星标 ★ 1404

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，本地部署，完全免费

项目预览

WebAI-to-API 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队Amm1rr

GitHubhttps://github.com/Amm1rr/WebAI-to-API

定价模式🏷️完全免费

价格说明开源项目，本地部署，完全免费

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,api,bard,chatbot,chatgpt,fastapi,free,gemini,gemini-api,google-bard-api,llm,python,uvicorn,webserver,webservice

GitHub 星标★ 1404

上线时间2023-07-22 00:00:00

代码更新2026-11-01

仓库体积5.5 MB

本站数据更新2026-11-08

维护状态较活跃

收录时间2026-08-09

浏览次数11

项目介绍

WebAI-to-API 是一个将网页版 AI 聊天界面（如 Google Bard、ChatGPT 等）封装成标准 API 的开源工具。它解决了开发者无法直接调用某些网页版 AI 服务官方 API 的问题，通过模拟浏览器交互或解析网页请求，将这些服务的对话能力以 RESTful API 的形式暴露出来。项目基于 Python 和 FastAPI 构建，支持异步处理，提供简单的部署方式（Uvicorn），并内置了多模型适配层，方便切换不同的 AI 后端。核心能力包括：统一的 API 接口、会话管理、流式响应支持，以及轻量级部署。它特别适合需要快速集成 AI 对话功能但预算有限或受限于官方 API 访问限制的开发者，可以低成本地将网页 AI 能力接入自己的应用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1404

技术标签

ai api bard chatbot chatgpt

使用教程

难度：进阶约 10 分钟部署方式：本地安装 6 步

环境要求

Git
Python >=3.11,<3.13
Poetry
Windows 需 Python 3.11.10+ 或 3.12.4+（Gemini WebAPI 临时 cookie 缓存安全要求）

安装与启动步骤

1克隆仓库

从 GitHub 拉取项目源码，网络不通时需配置代理。
```
git clone https://github.com/Amm1rr/WebAI-to-API.git
```
2进入项目目录

后续所有安装和启动命令都需在该目录下执行。
```
cd WebAI-to-API
```
3Linux/macOS 安装

运行安装脚本，它会创建缺失配置与运行时状态、装依赖和 Playwright Chromium 并跑诊断。
```
./install.sh
```
4Windows 安装

在 PowerShell 中运行安装脚本，作用与 Linux 脚本一致，注意 Python 版本要求。
```
.\install.ps1
```
5Docker 部署

可选部署方式，先拉取最新代码，再用 compose 构建并后台启动，需填写 UID/GID。
```
git pull
APP_UID=$(id -u) APP_GID=$(id -g) docker compose up -d --build
```
6修改配置

在 config.conf 和 .env 中设置 Gemini 后端（webapi 或 playwright）、默认模型、provider 开关、代理与日志。

关键配置

配置项	必填	说明	示例
`config.conf`	是	配置 Gemini 后端选择、默认模型、provider 启用、代理、日志、Atlas API 访问	`按 docs/configuration.md 填写`
`.env`	是	与 config.conf 配合的环境变量配置，含代理、日志与 Atlas API 访问	`按 docs/configuration.md 填写`
`[Gemini].extended_thinking`	否	设置扩展思考默认开关，也可在请求中按 provider_options 覆盖	`true`

如何确认成功

安装脚本会自动运行诊断；服务启动后访问其 Health / Readiness 健康检查端点返回正常即部署成功。

常见问题

Q：Windows 上 Python 版本有什么要求？

A：需 Python 3.11.10+ 或 3.12.4+，用于安全的 Gemini WebAPI 临时 cookie 缓存处理。

Q：install.sh / install.ps1 做了什么？

A：创建缺失的配置文件和运行时状态，安装项目依赖与 Playwright Chromium，然后运行诊断。

Q：如何切换 Gemini 后端？

A：在 config.conf 和 .env 中把 Gemini 后端配置为 webapi 或 playwright。

Q：是否支持流式输出和连续对话？

A：支持，提供 SSE 流式响应与对话续接，接口为 OpenAI 兼容的 /v1/chat/completions。

注意事项

需先安装 Git、Python（>=3.11,<3.13）与 Poetry。
安装与故障排查的完整说明见仓库 docs/installation.md，Docker 细节见 docs/docker.md，配置细节见 docs/configuration.md。
README 未给出默认端口与 API Key 取值，请以仓库配置文件和文档为准。

核心亮点

无需官方API密钥，直接复用网页版AI能力，降低使用门槛
基于FastAPI构建，接口标准，易于二次开发和扩展
支持多模型适配（Bard、ChatGPT等），切换灵活

不足之处

依赖网页版AI的稳定性，网页结构变动可能导致功能失效
文档/社区待观察

适用场景

个人开发者快速搭建AI聊天机器人原型
企业内部工具集成AI对话功能，但无法申请官方API
教学演示或研究，探索不同AI模型的对话能力

替代项目

revChatGPT、chatgpt-api、BardAPI

上一篇：parallax

下一篇：Claude-API