CJackHwang GitHub avatar

AIstudioProxyAPI

Python
AI Studio 代理网关CJackHwang最近推送 2026年4月22日
模型推理与部署AGPL-3.02,53042823 issues7 天 +4

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 三种启动方式。

推荐指数

4.0

想把 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. 第 1 步

    启动服务

    通过 launch_camoufox.py 读取 .env 配置并启动 FastAPI 应用。

  2. 第 2 步

    接收请求

    FastAPI 接收 OpenAI 格式的聊天请求,并做参数转换。

  3. 第 3 步

    浏览器转发

    Playwright 驱动 Camoufox 浏览器操作 Google AI Studio 页面完成对话。

  4. 第 4 步

    返回结果

    将页面结果按 OpenAI 标准格式返回,流式请求走独立流式代理端口。

快速上手

  1. 1

    克隆并安装

    克隆仓库后用 Poetry 安装依赖。

    git clone https://github.com/CJackHwang/AIstudioProxyAPI.git && cd AIstudioProxyAPI && poetry install --with dev
  2. 2

    配置环境

    复制示例配置,确认端口、代理和函数调用模式等项。

    cp .env.example .env
  3. 3

    首次认证

    用 debug 模式完成登录并保存认证信息。

    poetry run python launch_camoufox.py --debug
  4. 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 浏览器环境。

主题标签

camoufoxgoogle-ai-studiomiddlewareopenai-apiplaywrightproxypythonreverse-proxyapifastapiopenai