AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日
把 Google AI Studio 网页包装成 OpenAI 兼容 API 的代理服务。
这是一个用 FastAPI + Playwright + Camoufox 实现的中间层代理服务器。它通过浏览器自动化把 OpenAI 格式的 API 请求转发到 Google AI Studio Chat,再按 OpenAI 标准格式返回结果,并支持参数转发。项目内置调试 WebUI 面板,提供 CLI、Web UI 和桌面 GUI 三种启动方式。
推荐指数
想把 AI Studio 网页接入 OpenAI 生态的开发者可以一试,但依赖浏览器自动化,稳定性受网页变动影响。
近 7 天
+4
新增 Star
总 Star 排名
#1959
雷达追踪的 3,958 个 AI 仓库中
创建于
2025
2025年4月27日
核心亮点
1OpenAI 兼容
提供 /v1/chat/completions 和 /v1/models 接口,现有客户端可直接接入。
2函数调用三模式
支持 auto、native、emulated 三种模式,并可在失败时回退。
3认证轮转
支持 profile 自动轮转、Cookie 周期刷新与关停保存。
4内置 Web UI
自带设置页、状态检查和日志查看面板。
5多种启动方式
提供 CLI 启动器、Web UI 和桌面 GUI 启动器。
适用场景
接入现有 OpenAI 客户端
例如:在 Open WebUI 中把 API Base URL 填为 http://127.0.0.1:2048/v1 后直接对话。
本地统一调用入口
例如:用 curl 向 /v1/chat/completions 发送 gemini-2.5-pro 模型请求。
无图形界面的服务器部署
例如:在 Linux 上用 --headless 或 --virtual-display 模式长期运行。
它是怎么工作的
第 1 步
启动服务
通过 launch_camoufox.py 读取 .env 配置并启动 FastAPI 应用。
第 2 步
接收请求
FastAPI 接收 OpenAI 格式的聊天请求,并做参数转换。
第 3 步
浏览器转发
Playwright 驱动 Camoufox 浏览器操作 Google AI Studio 页面完成对话。
第 4 步
返回结果
将页面结果按 OpenAI 标准格式返回,流式请求走独立流式代理端口。
快速上手
- 1
克隆并安装
克隆仓库后用 Poetry 安装依赖。
git clone https://github.com/CJackHwang/AIstudioProxyAPI.git && cd AIstudioProxyAPI && poetry install --with dev - 2
配置环境
复制示例配置,确认端口、代理和函数调用模式等项。
cp .env.example .env - 3
首次认证
用 debug 模式完成登录并保存认证信息。
poetry run python launch_camoufox.py --debug - 4
日常启动
认证完成后用无头模式运行,访问 2048 端口使用 Web UI。
poetry run python launch_camoufox.py --headless
适合谁
- 已有 OpenAI 兼容客户端、想接入 AI Studio 的开发者
- 需要本地或自建统一 API 入口的个人用户
- 能接受浏览器自动化方案的运维人员
不太适合
- 需要高并发、强稳定性的生产环境
- 不愿维护浏览器和登录态的用户
成熟度
- 活跃度2025 年创建,最近一次推送在 2026 年 4 月,仍在持续更新。
- 文档README 覆盖快速开始、架构、配置和客户端示例,并链接多篇详细文档。
- 社区约 2500 star、428 fork,23 个未关闭 issue,有社区贡献者。
- 上手难度需要 Poetry、Node.js 和浏览器环境,首次还要手动登录认证。
使用前注意
- · 采用 AGPL-3.0 许可,商用或分发时需注意开源义务。
- · 依赖浏览器自动化操作网页,Google AI Studio 页面变动可能导致失效。
- · 需要自行维护 Google 账号登录态和 Cookie,存在账号风险。
- · 运行需要至少 2GB 内存,并依赖 Camoufox 浏览器环境。
