AIstudioProxyAPI：将 Google AI Studio 转换为 OpenAI 兼容 API

AIstudioProxyAPI 是一个将 Google AI Studio 网页界面转换为 OpenAI 兼容 API 的代理服务器。通过 Camoufox（反指纹检测 Firefox）和 Playwright 自动化技术，该项目提供了稳定的 API 访问方式，让开发者能够以标准 OpenAI API 格式调用 Google AI Studio 的强大能力。

项目简介

该项目由 CJackHwang 开发维护，截至目前在 GitHub 上已获得 2.1k stars 和 365 forks，拥有 21 位贡献者。项目采用 AGPL-3.0 开源协议，主要使用 Python 编写。

核心功能是通过浏览器自动化模拟人工操作，将 API 请求转发到 Google AI Studio 网页，并按照 OpenAI 标准格式返回结果。项目内置调试 WebUI 面板，方便开发者进行测试和监控。

核心特性

• OpenAI 兼容 API：完全兼容 OpenAI API 格式，支持参数转发
• Camoufox 反检测：使用 Camoufox 反指纹检测浏览器，避免被识别为自动化工具
• Playwright 自动化：基于 Playwright 实现稳定的浏览器自动化
• 内置 WebUI 面板：提供调试界面，方便测试和监控
• Docker 支持：支持 Docker 一键部署，简化运维
• 多模式运行：支持有头/无头模式，适应不同场景

技术栈

• FastAPI - 高性能异步 Web 框架
• Playwright - 浏览器自动化工具
• Camoufox - 反指纹检测 Firefox 浏览器
• Poetry - Python 依赖管理和打包工具
• Docker - 容器化部署

系统要求

安装指南

方式一：本地部署

# 1️⃣ 克隆并安装
git clone https://github.com/CJackHwang/AIstudioProxyAPI.git
cd AIstudioProxyAPI
poetry install

# 2️⃣ 配置环境
cp .env.example .env
nano .env
# 设置 AUTO_SAVE_AUTH=true 以保存认证

# 3️⃣ 首次认证并启动
poetry run python launch_camoufox.py --debug
# 首次认证（需登录 Google）

# 认证成功后，将 auth_profiles/saved/*.json 移至 auth_profiles/active/
# 然后：
poetry run python launch_camoufox.py --headless

方式二：Docker 部署

cd docker
cp .env.docker .env
nano .env
docker compose up -d
docker compose logs -f

# 版本更新
bash update.sh

快速测试

# 健康检查
curl http://127.0.0.1:2048/health

# 获取模型列表
curl http://127.0.0.1:2048/v1/models

# 测试聊天
curl -X POST http://127.0.0.1:2048/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3-pro-preview","messages":[{"role":"user","content":"Hello"}]}'

核心配置

运行模式

客户端配置示例

项目支持多种客户端配置，包括但不限于：

• OpenAI Python SDK
• OpenAI Node.js SDK
• LangChain
• 其他兼容 OpenAI API 的客户端

配置时只需将 API base URL 修改为 http://127.0.0.1:2048/v1 即可。

项目链接

• GitHub 仓库：https://github.com/CJackHwang/AIstudioProxyAPI
• 最新版本：v4.0.6_py（发布于 2026-02-08）
• 许可证：AGPL-3.0

贡献与支持

欢迎提交 Issue 和 Pull Request！如果本项目对您有帮助，欢迎支持作者的持续开发。

注意：使用本项目时请遵守 Google AI Studio 的使用条款和相关法律法规。