WebAI2API

为什么你需要了解 WebAI2API？

相信很多人都有过这样的困惑：ChatGPT、Gemini、豆包这些AI服务的网页版每天可以免费使用，但想在自己的程序、AI Agent或自动化脚本里调用时，官方API的Token费用却让人望而却步。有没有一种方法，既享受网页版免费的“福利”，又能像正规API一样轻松集成？

答案是肯定的。WebAI2API 正是这样一款应运而生的神器，它能够将LMArena、Gemini、ChatGPT、豆包、DeepSeek等网页版AI服务，一键转换成兼容OpenAI协议的标准API接口。

本文将为你详细介绍这款工具，并提供保姆级使用教程，带你轻松实现“白嫖”到“集成”的无缝衔接。

一、核心功能解析

WebAI2API 在技术上并非传统的逆向工程，而是基于 Camoufox (Playwright) 框架，模拟真实用户的浏览器操作（包括人类打字和鼠标轨迹），从而规避自动化检测，稳定地与AI网站交互。

它的核心功能包括：

• 拟人交互：模拟人类打字速度和鼠标轨迹，有效规避网站的反爬机制。
• 接口兼容：对外提供标准的 OpenAI 格式接口（支持 /v1/chat/completions），并支持流式响应（SSE）。
• 多窗囗并发：支持多窗囗并发执行，可配置独立代理，实现多个账号的浏览器实例级数据隔离。
• 稳定防护：内置任务队列、负载均衡、故障转移和错误重试机制，保证长时间运行的稳定性。
• 可视化管理：提供了一个 Web UI，方便查看实时日志、进行 VNC 远程连接和管理适配器。

二、当前支持的AI模型列表

WebAI2API 目前已经对主流AI网站进行了适配，并且社区还在持续更新。主要支持情况如下：

以上为部分列表，你可以通过访问 GET /v1/models 接口获取当前配置下的完整模型列表。

三、保姆级部署教程

WebAI2API 支持源码部署和 Docker 部署，无论你是否熟悉编程都能轻松上手。推荐使用 Docker 方式，环境隔离且操作简单。

环境要求

• Node.js：v20.0.0+
• 操作系统：Windows / Linux / macOS
• 包管理工具：pnpm（如使用源码部署）
• Docker（如使用容器部署）

方法一：Docker 部署（强烈推荐）

这是目前最快、最稳定的方式。Docker 镜像内置了 Xvfb 虚拟显示器，解决了浏览器在无头环境下的运行问题。

1. 使用 Docker CLI 一键运行：

   docker run -d --name webai-2api \
     -p 3000:3000 \
     -v "$(pwd)/data:/app/data" \
     --shm-size=2gb \
     foxhui/webai-2api:latest

   安全提示：Docker 镜像默认开启了 VNC 服务以便远程屏幕查看，且 WebUI 传输过程未加密。如果你要将服务部署在公网，务必配合 SSH 隧道或配置 HTTPS 反向代理使用。

2. 使用 Docker Compose：
   你可以在项目根目录编写 docker-compose.yml 文件，然后执行 docker-compose up -d 一键启动。

方法二：源码手动部署

如果你想要进行二次开发，或者想在 Windows 本地直接运行，可以选择手动部署。

1. 克隆项目：

   git clone https://github.com/foxhui/WebAI2API.git
   cd WebAI2API

2. 安装依赖：

   pnpm install

3. 初始化浏览器环境：

   npm run init

   注意：该脚本需要从 GitHub 下载资源，如果网络受限，可以通过代理运行：

   npm run init -- -proxy=http://username:passwd@host:port

4. 启动服务：

   npm start

如果你使用的是 Linux 服务器并且没有图形界面，请使用 npm start -- -xvfb -vnc 启动虚拟显示模式。

四、API 调用实战

启动成功后，你会看到一个运行在 3000 端口上的服务。WebAI2API 提供完全兼容 OpenAI协议的 API 接口，意味着你可以直接使用 OpenAI SDK 或任何兼容 OpenAI API 的客户端（如 NextChat、LobeChat、OpenClaw 等）来调用。

1. 配置客户端

在支持 OpenAI 协议的客户端中，进行如下配置：

• API 地址：http://你的服务器IP:3000/v1/chat/completions （如果运行在本地，则是 http://localhost:3000/v1/chat/completions）
• API Key：填入你在配置文件中设置的 auth Token，默认为 sk-change-me-to-your-secure-key。

修改 Auth Key：强烈建议修改默认 Key。你可以通过配置文件修改，也可以使用项目提供的命令生成随机强密钥：npm run genkey。

2. 使用 cURL 测试

你也可以直接使用 cURL 命令进行测试，验证服务是否正常：

curl --location 'http://localhost:3000/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-change-me-to-your-secure-key' \
--data '{
    "model": "gpt-3.5-turbo", 
    "messages": [
        {"role": "user", "content": "介绍一下什么是 WebAI2API？"}
    ]
}'

3. 查看管理界面

访问 http://localhost:3000/ 即可进入 Web 管理后台，你可以在这里查看实时的 API 调用日志、系统负载，甚至通过 VNC 远程查看浏览器在执行什么操作。

五、安全与稳定性建议

为了让 WebAI2API 运行得更长久、更安全，有几点值得留意：

• 安全加固：在使用反向代理（如 Nginx、Caddy）时，建议开启 HTTPS 加密传输。同时，务必修改配置文件中的 auth Key，防止服务被他人滥用。
• 账号策略：建议为网页 AI 准备多个小号。利用 WebAI2API 的“多窗囗并发”功能，可以实现账号轮询，既提高了并发量，也在一定程度上降低了风控风险。
• DNS 解析：部分用户反映在部署时遇到安装脚本卡死，多是因为访问 raw.githubusercontent.com 等域名不稳定。建议配置系统级代理，或者在服务器上修改 hosts 文件。

常见问题与实用建议

Q1：初始化时网络报错怎么办？

安装浏览器等预编译依赖时，需要连接 GitHub 下载资源。若网络受限，请使用代理：

npm run init -- -proxy=http://username:passwd@host:port

Q2：API 调用时返回 401 怎么办？

检查请求头中的 Authorization 字段是否与服务端 data/config.yaml 中配置的 auth 值一致。生产环境务必使用 npm run genkey 生成随机 Token。

Q3：Docker 部署后无法访问 WebUI 或 API？

检查端口映射是否正确（-p 3000:3000），以及防火墙规则是否放行 3000 端口。

Q4：如何查看浏览器运行状态？

通过 WebUI 管理界面的“虚拟显示器”板块，可以实时查看浏览器画面和操作日志。

Q5：如何添加新的 AI 平台？

项目持续更新适配器列表，可通过 GET /v1/models 查看当前支持的模型。如需增加未预置的平台，可关注项目 GitHub 的适配器开发文档。

总结

WebAI2API 是一款极具创新精神和实用价值的开源工具。它打破了网页版 AI 与程序化 API 之间的壁垒，让开发者无需支付昂贵的 Token 费用，也能享受到前沿 AI 模型的能力。

无论是用于快速原型开发、AI Agent 搭建，还是作为企业内部的多模型管理网关，WebAI2API 都是一个值得尝试的选择。

项目地址：https://github.com/foxhui/WebAI2API
在线文档：https://foxhui.github.io/WebAI2API/
Docker 镜像：docker pull foxhui/webai-2api:latest