将 Google AI Studio 网页界面转换为 OpenAI 兼容 API 的代理服务器。通过 Camoufox (反指纹检测 Firefox) 和 Playwright 自动化，提供稳定的 API 访问。

• OpenAI 兼容 API: 完全兼容 /v1/chat/completions 端点和主流客户端
• 三层流式响应机制: 集成流式代理 → 外部 Helper → Playwright 页面交互
• 智能模型切换: 动态切换 AI Studio 模型，完整参数控制
• 反指纹检测: Camoufox 浏览器降低被检测风险
• 现代化 Web UI: 内置测试界面、状态监控、API 密钥管理
• 脚本注入 v3.0: Playwright 原生网络拦截，支持油猴脚本动态挂载

详细指南请参考 快速开始指南

# 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

# 健康检查
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"}]}'

访问 http://127.0.0.1:2048/ 使用内置 Web UI。

graph TD
    subgraph "用户端"
        User["用户"]
        WebUI["Web UI"]
        API_Client["API 客户端"]
    end

    subgraph "启动与配置"
        CLI_Launch["launch_camoufox.py"]
        EnvConfig[".env 配置"]
    end

    subgraph "核心应用"
        FastAPI_App["FastAPI 应用<br/>api_utils/"]
        PageController["页面控制器<br/>browser_utils/"]
        StreamProxy["流式代理<br/>stream/"]
    end

    subgraph "外部依赖"
        CamoufoxInstance["Camoufox 浏览器"]
        AI_Studio["Google AI Studio"]
    end

    User --> CLI_Launch
    API_Client & WebUI --> FastAPI_App
    FastAPI_App --> PageController & StreamProxy
    PageController --> CamoufoxInstance --> AI_Studio
    StreamProxy --> AI_Studio

项目使用 .env 文件统一配置管理：

cp .env.example .env
nano .env

详细配置: 环境变量完整参考

cd docker
cp .env.docker .env
nano .env

docker compose up -d
docker compose logs -f

# 版本更新
bash update.sh

详细指南: Docker 部署指南

• 快速开始指南 - 15 分钟快速部署 🎯
• 安装指南 - 详细安装步骤
• 认证设置指南 - 首次认证设置
• 日常运行指南 - 日常使用

• API 使用指南 - API 端点和配置
• OpenAI 兼容性说明 - 与 OpenAI API 差异 🔄
• 客户端集成示例 - 代码示例 💻
• Web UI 使用指南 - Web 界面功能
• 脚本注入指南 - 油猴脚本功能 (v3.0)

• 环境变量配置指南 - 配置管理 ⭐
• 环境变量完整参考 - 所有配置项 📋
• 流式处理模式详解 - 三层响应机制
• 高级配置指南 - 高级功能
• 故障排除指南 - 问题解决

• 项目架构指南 - 模块化架构
• 开发者指南 - Poetry、Pyright 工作流

以 Open WebUI 为例：

1. 进入 "设置" → "连接"
2. 添加模型，API 基础 URL: http://127.0.0.1:2048/v1
3. API 密钥: 留空或任意字符
4. 保存并开始聊天

• 项目发起与主要开发: @CJackHwang
• 核心维护 (架构重构、测试体系): @NikkeTryHard
• 功能完善、页面操作优化: @ayuayue
• 实时流式功能优化: @luispater
• 项目重构贡献: @yattin (Holt)
• 社区支持: Linux.do 社区

欢迎提交 Issue 和 Pull Request！

AGPLv3

如果本项目对您有帮助，欢迎支持作者的持续开发：