AI Studio to OpenAI, Anthropic & Gemini Compatible API

三步开始使用：下载 Releases 并启动 → 在“账户”页添加 Google 账户 → 点击“启动服务”，把 http://127.0.0.1:2048 作为 OpenAI、Anthropic 或 Gemini 客户端的 Base URL

🧩 Google 反代全家桶

三个项目分别接入 AI Studio、Gemini 网页版与 Antigravity，把各自的模型转为 OpenAI、Anthropic 与 Gemini 兼容接口，供 Claude Code、Codex 等 Agent 客户端和 SillyTavern 等酒馆前端使用。

---

核心能力

• 双通道: 每个账户经 Playground 生成；Build 应用代理是旧通道，上游已对账户停用其生成（PROXY_GENERATION_DISABLED），默认关闭，可在 UPSTREAM_CHANNELS 中启用；启用后经 Build 发送的生成请求返回上游原因；免费账户的两个通道共用同一模型的每日请求次数
• 多账户高并发: 识别 Free、Pro、Ultra 与 Plus 权益，按实时模型目录在账户间轮询或优先复用
• 两种 WAA 后端: 默认由服务进程内的 SpiderMonkey（Firefox 的 JavaScript 引擎）生成官方 proof，运行时不下载、不启动浏览器；设置 WAA_BACKEND=camoufox 后由 Camoufox 持有官方 WAA 生命周期
• 四套 API 协议: OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 与 Gemini GenerateContent；Responses 支持 /v1/responses/compact 与 compaction、compaction_trigger 输入项的上下文压缩，Anthropic Messages 支持 context_management 的工具结果与思考清理和阈值压缩
• 主流 Agent 客户端: 支持 Claude Code、Codex、OpenCode、pi、omp、dsh、OpenClaw、Magpie 的文件读写工具调用，Claude Code、Codex、omp 的原生联网搜索可直接使用

特性

• 原生流式响应: 实时输出正文、思考摘要、函数调用、Google 工具、媒体和 usage
• 函数工具: 四协议支持工具调用与续接、工具选择和严格参数校验；支持联合类型与开放参数定义
• TTS 语音生成: 支持 Gemini TTS 模型的单/多说话人音频生成
• 图片生成: 支持 Nano Banana 图片生成
• 视频生成: 视频长任务与图片转视频由 Gemini Omni 生成；Gemini Omni 通过四套生成接口接收文本、图片与视频输入，输出文本与 MP4 视频
• Deep Research: Pro 与 Ultra 账户可通过四套生成接口与 Interactions 的 agent 字段调用 Deep Research，输出研究过程、带引用的报告与图表
• 决策模型: gemini-decision-1 经 /v1beta/decisions 对同一份输入一次回答多个是非、单选与评分问题，返回校准后的概率与置信度；输入可以是文本、图片、音频、视频与 PDF，只计输入 token；AI Studio 官网前端尚未调用这个模型，服务经网页的 CreateDecision 请求调用
• YouTube 输入: YouTube 视频 URL 作为外部视频附件读取；开启 YOUTUBE_LINKS 后，消息文本中的 YouTube 链接同样作为视频读取
• 视频理解设置: Gemini 与 Interactions 支持逐视频的起止时间、0–24 FPS 范围内的正数采样率和静态/Agentic 处理；Agentic 返回服务端处理步骤并支持历史续接
• 智能模型切换: 从 AI Studio 实时发现模型并按 model 字段路由；开启 DISCOVER_HIDDEN_MODELS 后，官网前端已配置、账户模型列表尚未列出的模型经上游确认可用后同样可以调用
• Google 工具: 支持 Search、Image Search、URL Context、Code Execution 和 Maps
• Files 与 Transcribe: 支持文件上传、查询、内容读取、删除和音频转录
• Live 与 Robotics: 通过 WebSocket 支持文本、音频、JPEG、媒体结束、工具调用、恢复和中断
• 反指纹检测: 为每个账户固定 Firefox 指纹与出口，官方 WAA 在 SpiderMonkey 的 Firefox 页面环境或 Camoufox 页面中运行
• 图形界面启动器: 通过网页管理账户、服务启停、实时日志、模型、请求、用量统计和配置，界面提供深色与浅色两种配色，以及简体中文、繁體中文、English、日本語、한국어、Français 与 Deutsch 七种语言
• 桌面版: Windows、macOS 与 Linux 桌面应用在窗口中显示管理页面，关闭窗口后在系统托盘继续运行
• 在线更新: 管理端“版本”页显示最新发行版本与更新说明，桌面版与 Linux、macOS 命令行版一键下载、校验并重启到新版本，Linux deb 安装时由系统弹出管理员认证
• 模块化架构: Go 负责协议、调度、API 与管理端，SpiderMonkey 或 Camoufox 负责 WAA 运行时，Camoufox 负责隔离登录

系统要求

• Windows Release 运行: Windows 10 或更高版本；系统没有 WebView2 运行时时，桌面版询问是否从微软下载安装，安装进度显示在微软安装程序的窗口中，安装完成后打开桌面窗口；取消或安装失败时在默认浏览器中打开管理页面
• macOS 桌面版: macOS 13 或更高版本，Apple 芯片与 Intel 通用
• Linux 桌面版: GTK 3 与 WebKitGTK 4.1，例如 Ubuntu 22.04、Debian 12 或更新版本；deb 安装时一并安装这些依赖与 Camoufox 运行库，AppImage 另需下一行的 Camoufox 运行库
• Linux Release 运行: 解压 linux-amd64.tar.gz 后运行 ./aistudio2api，Camoufox 需要 Firefox 系运行库与 Xvfb，Debian/Ubuntu 执行 sudo apt-get update && sudo apt-get satisfy -y "libgtk-3-0, libasound2t64 | libasound2, libx11-xcb1, xvfb"
• 源码运行: Go 1.27+、Node.js 22.18+、24.11+ 或 26+，以及配套 npm；C/C++ 编译器，Windows 为 llvm-mingw 的 UCRT 版 clang，macOS 为 Xcode Command Line Tools，Linux 为 Zig 0.16；当前平台的 SpiderMonkey 与 libwebp 静态库，分别从 Mag1cFall/firefox 与 Mag1cFall/libwebp 的 Releases 下载
• 操作系统: Windows、macOS、Linux
• 内存: 默认的 SpiderMonkey 后端单账户在 macOS 上约 100 MB、Windows 与 Linux 上约 150 MB，每增加一个常驻预热账户约增加 55 MB；Camoufox 后端单账户在 Windows 与 macOS 上约 0.5 GB、Linux 上约 0.7 GB，每增加一个常驻预热账户约增加 0.4 GB
• CPU: SpiderMonkey 后端空闲时几乎不占用，Camoufox 后端空闲时每个常驻预热账户约占单核的 0.5%；两个后端每个请求的 CPU 时间都在 0.1 秒以内
• 网络: 稳定的互联网连接访问 Google AI Studio

安装步骤

方式一：Windows 一键启动（推荐）

从 Releases 下载 windows-amd64.zip 发布包，解压后双击 aistudio2api.exe：

• 管理页面在桌面窗口中打开；启动时先显示启动画面，管理服务就绪后进入管理页面
• 关闭窗口后程序在系统托盘继续运行：双击托盘图标显示窗口，右键打开托盘菜单；菜单可以显示窗口、在浏览器中打开管理页面、开关开机自启动或退出
• 再次双击 aistudio2api.exe 唤回已运行的窗口

从源码启动时：

git clone https://github.com/Mag1cFall/AIStudio2API.git
cd AIStudio2API
copy .env.example .env
cd web
npm ci
npm run build
cd ..
mkdir spidermonkey
curl.exe -L -o spidermonkey\windows.tar.gz https://github.com/Mag1cFall/firefox/releases/download/v158.0.1-aistudio2api.1/spidermonkey-v158.0.1-aistudio2api.1-windows-amd64.tar.gz
tar -xzf spidermonkey\windows.tar.gz -C spidermonkey
mkdir libwebp
curl.exe -L -o libwebp\libwebp.tar.gz https://github.com/Mag1cFall/libwebp/releases/download/v1.6.0-aistudio2api.1/libwebp-v1.6.0-aistudio2api.1-windows-amd64.tar.gz
tar -xzf libwebp\libwebp.tar.gz -C libwebp
$env:CC = "x86_64-w64-mingw32-clang"
$env:CXX = "x86_64-w64-mingw32-clang++"
$env:CGO_CPPFLAGS = "-I$PWD\spidermonkey\include -I$PWD\libwebp\include"
$env:CGO_LDFLAGS = "-L$PWD\spidermonkey\lib -L$PWD\libwebp\lib"
go build -o aistudio2api.exe ./cmd/aistudio2api
.\aistudio2api.exe

x86_64-w64-mingw32-clang 来自 llvm-mingw 的 ucrt-x86_64 包，解压后把其中的 bin 目录加入 PATH。

WAA_BACKEND=camoufox 时，程序在管理服务启动后于后台下载当前平台的 Camoufox 到 runtime/camoufox/，生成服务在下载完成后就绪；默认的 SpiderMonkey 后端在第一次使用浏览器登录时下载。下载期间管理页面显示进度，公开 API 请求返回说明下载进度的 503：

• 下载经 PROXY 的第一个代理发出，未设置时使用系统代理
• 下载中断或连续 30 秒收不到数据时，管理页面显示原因并可重试，重试从已下载的部分继续
• 环境变量 CAMOUFOX_PATH 可以指定已有的同版本可执行文件，版本不符时管理页面给出所需版本

方式二：macOS 与 Linux 桌面版

macOS 从 Releases 下载 darwin-universal.dmg，打开后把 AIStudio2API.app 拖入“应用程序”。应用使用 ad-hoc 签名，首次打开被系统拦截时，在“系统设置 → 隐私与安全性”中点击“仍要打开”，或执行：

xattr -dr com.apple.quarantine /Applications/AIStudio2API.app

macOS 版关闭窗口后在菜单栏继续运行：单击菜单栏图标显示窗口，右键打开菜单，点 Dock 图标或从“应用程序”再次打开时显示窗口。

Linux 下载 linux-amd64.AppImage 赋予执行权限后运行，或安装 linux-amd64.deb 后从应用菜单启动 AIStudio2API：

This is the beginning of the README. Read the rest at the original. Read the full README ↗