账户 权益与状态	用量 请求与费用	日志 请求与速度
模型目录 实时目录	设置 页面改配置	图片生成 文生图改图
API 试用页 官网同款对话页、思考过程与代码块

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

核心能力

• 双通道: 每个账户经 Playground 生成；Build 应用代理是旧通道，上游已对账户停用其生成（PROXY_GENERATION_DISABLED），默认关闭，可在 UPSTREAM_CHANNELS 中启用；启用后经 Build 发送的生成请求返回上游原因；免费账户的两个通道共用同一模型的每日请求次数
• Build 对话模型: Build 对话面板可选的模型各提供一个 <模型>-build（如 gemini-3.8-flash-build），由 Build 写代码助手连同其系统提示词回复，支持函数调用、工具结果续接与 Google 搜索，用量计入 Build 对话额度（免费请求或 Google AI 订阅额度）。⚠️ 这类模型的每次请求都带有 Build 写代码助手自带的系统提示词注入，回答风格、格式与身份会受其影响，请按用途自行评估
• 多账户高并发: 识别 Free、Pro、Ultra 与 Plus 权益，按实时模型目录在账户间轮询或优先复用
• 两种 WAA 后端: 默认由 Camoufox 持有官方 WAA 生命周期；设置 WAA_BACKEND=spidermonkey 后由服务进程内的 SpiderMonkey（Firefox 的 JavaScript 引擎）生成官方 proof，运行时不下载、不启动浏览器
• 四套 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、OpenClaw、Hermes 的文件读写工具调用，Claude Code、Codex、omp 的原生联网搜索可直接使用

特性

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

系统要求

• Windows Release 运行: Windows 10 或更高版本；系统没有 WebView2 运行时时，桌面版询问是否从微软下载安装，安装进度显示在微软安装程序的窗口中，安装完成后打开桌面窗口；取消或安装失败时在默认浏览器中打开管理页面
• macOS 桌面版: macOS 12 或更高版本，Apple 芯片与 Intel 通用
• Linux 桌面版: GTK 4 与 WebKitGTK 6.0，例如 Ubuntu 24.04、Debian 13 或更新版本；deb 安装时一并安装这些依赖与 Camoufox 运行库，AppImage 另需下一行的 Camoufox 运行库
• Linux Release 运行: 解压 linux-amd64.tar.gz 后运行 ./aistudio2api，Camoufox 需要 Firefox 系运行库，Debian/Ubuntu 执行 sudo apt install libgtk-3-0 libasound2 libnss3 libdbus-glib-1-2 libxtst6 libxrandr2 libgbm1 libxkbcommon0 libpango-1.0-0 libcairo2 libxcomposite1 libxdamage1 libxfixes3 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 静态库，从 Mag1cFall/firefox Releases 下载
• 操作系统: Windows、macOS、Linux
• 内存: 单账户建议 2GB+ 可用内存，每个常驻预热账户约增加 0.6GB
• 网络: 稳定的互联网连接访问 Google AI Studio

安装步骤

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

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

• 管理页面在桌面窗口中打开；首次启动先显示启动画面，Camoufox 下载完成后进入管理页面
• 关闭窗口后程序在系统托盘继续运行：双击托盘图标显示窗口，右键打开托盘菜单；菜单可以显示窗口、在浏览器中打开管理页面、开关开机自启动或退出
• 再次双击 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/v152.0.4-aistudio2api.1/spidermonkey-v152.0.4-aistudio2api.1-windows-amd64.tar.gz
tar -xzf spidermonkey\windows.tar.gz -C spidermonkey
$env:CC = "x86_64-w64-mingw32-clang"
$env:CXX = "x86_64-w64-mingw32-clang++"
$env:CGO_CXXFLAGS = "-I$PWD\spidermonkey\include"
$env:CGO_LDFLAGS = "-L$PWD\spidermonkey\lib"
go build -o aistudio2api.exe ./cmd/aistudio2api
.\aistudio2api.exe

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

首次启动会自动下载当前平台的 Camoufox 到 runtime/camoufox/：

• 下载经 PROXY 的第一个代理发出，未设置时使用系统代理
• 下载中断后，下次启动从已下载的部分继续
• 环境变量 CAMOUFOX_PATH 可以指定已有的同版本可执行文件，版本不符时启动报错并给出所需版本

方式二：macOS 与 Linux 桌面版

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

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

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

chmod +x aistudio2api-<版本>-linux-amd64.AppImage
./aistudio2api-<版本>-linux-amd64.AppImage
sudo apt install ./aistudio2api-<版本>-linux-amd64.deb

桌面版的 .env、auth/ 与 runtime/ 位置：

• macOS：~/Library/Application Support/AIStudio2API/
• Linux：~/.config/AIStudio2API/

setup 等命令在终端中运行桌面版的可执行文件，例如 /Applications/AIStudio2API.app/Contents/MacOS/aistudio2api setup --login；deb 安装的可执行文件为 aistudio2api。

方式三：Linux 与 macOS 源码构建

1. 安装依赖

• Go 1.27 或更高版本
• Node.js 22.18+、24.11+ 或 26+，以及配套 npm
• C/C++ 编译器：macOS 为 Xcode Command Line Tools，Linux 为 Zig 0.16

2. 克隆项目

git clone https://github.com/Mag1cFall/AIStudio2API.git
cd AIStudio2API
cp .env.example .env

3. 构建并运行

cd web
npm ci
npm run build
cd ..
arch=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
platform=$([ "$(uname -s)" = Darwin ] && echo darwin || echo linux)
mkdir -p spidermonkey
curl -L https://github.com/Mag1cFall/firefox/releases/download/v152.0.4-aistudio2api.1/spidermonkey-v152.0.4-aistudio2api.1-$platform-$arch.tar.gz | tar -xz -C spidermonkey
export CGO_CXXFLAGS="-I$PWD/spidermonkey/include" CGO_LDFLAGS="-L$PWD/spidermonkey/lib"
if [ "$platform" = darwin ]; then
  go build -o aistudio2api ./cmd/aistudio2api
else
  target=$(uname -m)-linux-musl
  CC="zig cc -target $target" CXX="zig c++ -target $target" go build -tags netgo,osusergo -ldflags="-linkmode external -extldflags -static" -o aistudio2api ./cmd/aistudio2api
fi
./aistudio2api

Linux 与 macOS 首次运行同样会自动准备对应平台的 Camoufox。

方式四：Docker

mkdir aistudio2api && cd aistudio2api
curl -fsSLO https://raw.githubusercontent.com/Mag1cFall/AIStudio2API/main/docker-compose.yml
mkdir data
cat > data/.env <<'EOF'
PROXY_API_KEY=<API key>
ADMIN_AUTH_ENABLED=true
ADMIN_PASSWORD=<管理密码>
EOF
docker compose up -d

镜像支持 linux/amd64 与 linux/arm64，服务在容器内监听 0.0.0.0:2048。data/ 保存 .env、auth/ 与 runtime/，Camoufox 后端首次启动时把 Camoufox 下载到 data/runtime/camoufox/；迁移已有安装时把这三项复制到 data/。容器以 root 运行，服务写入 data/ 的文件属于 root，Linux 宿主机上用 sudo 编辑。

• 端口对外开放时设置 PROXY_API_KEY；从容器外打开管理页面需要 ADMIN_AUTH_ENABLED=true 与管理密码，用户名默认为 admin
• 添加账户：在管理页面“添加账户”中选择“浏览器登录”，在管理页面打开的登录窗口中登录 Google；也可以粘贴 Cookie，或把能登录 Google 的电脑上的 auth/<Google 邮箱>/ 复制到 data/auth/
• PROXY 与账户代理从容器内访问，代理运行在宿主机时填写宿主机的局域网地址，并允许代理接受局域网连接
• 修改 data/.env 后执行 docker compose restart；更新镜像执行 docker compose pull && docker compose up -d；在源码目录中执行 docker compose up -d --build 从源码构建

快速开始

首次使用（需要认证）

1. 准备首个账户:

Windows 可以导入本机 Chrome 账户：

powershell cmd /c start /wait aistudio2api.exe setup

Linux 与 macOS 使用隔离 Camoufox 登录：

bash ./aistudio2api setup --login

登录完成后会从 AI Studio 页面读取 Google 邮箱，并为账户授权 Google Drive。账户保存到 .env 中 AISTUDIO_AUTH_STATES 指向的目录；语言和时区默认读取当前电脑设置，也可以通过 --locale、--timezone 指定。

2. 启动图形界面: - Windows 双击 aistudio2api.exe - macOS 与 Linux 桌面版从应用程序启动，命令行版运行 ./aistudio2api - 桌面版在窗口中打开管理页面，命令行版在浏览器中打开 http://127.0.0.1:2048 - 页面初始状态为 STOPPED，默认显示“日志”页面

3. 添加其他账户: - 打开“账户”页面，点击“添加账户”选择方式 - “从 Chrome 导入”可多选本机 Chrome 账户 - “粘贴 Cookie”粘贴 Cookie 扩展（如 Cookie-Editor）在 aistudio.google.com 导出的 JSON、请求头中的 Cookie 一行或 Netscape cookies.txt，服务自动识别账户邮箱 - “从指纹浏览器导入”自动列出本机指纹浏