一个基于 Go 的高性能代理服务
将 Google AI Studio 网页协议转换为 OpenAI、Responses、Anthropic 和 Gemini 兼容 API
Playground 生成通道 •
Build 代码助手对话通道 •
多账户高并发
Camoufox 与 SpiderMonkey 双 WAA 后端 •
Claude Code、Codex 等 Agent 客户端 •
Nano Banana、TTS 与 Omni
![]() 账户 权益与状态 |
![]() 用量 请求与费用 |
![]() 日志 请求与速度 |
![]() 模型目录 实时目录 |
![]() 设置 页面改配置 |
![]() 图片生成 文生图改图 |
![]() API 试用页 官网同款对话页、思考过程与代码块 |
||
三步开始使用:下载 Releases 并启动 → 在“账户”页添加 Google 账户 → 点击“启动服务”,把 http://127.0.0.1:2048 作为 OpenAI、Anthropic 或 Gemini 客户端的 Base URL
三个项目分别接入 AI Studio、Gemini 网页版与 Antigravity,把各自的模型转为 OpenAI、Anthropic 与 Gemini 兼容接口,供 Claude Code、Codex 等 Agent 客户端和 SillyTavern 等酒馆前端使用。
| 官方 WAA proof 由 Camoufox 或进程内 SpiderMonkey 生成,账户像在官网一样对话 | 账户从本机 Chrome 一键导入,运行时只走纯 HTTP,未登录也能用访客会话 | 只模拟官方 Windows 客户端,TLS、请求信封与伴随请求逐字段一致 |
- 双通道: 每个账户经 Playground 生成;Build 应用代理是旧通道,上游已对账户停用其生成(
PROXY_GENERATION_DISABLED),默认关闭,可在UPSTREAM_CHANNELS中启用;启用后经 Build 发送的生成请求返回上游原因;免费账户的两个通道共用同一模型的每日请求次数 - Build 对话模型: Build 对话面板可选的模型各提供一个
<模型>-build(如gemini-3.8-flash-build),由 Build 写代码助手连同其系统提示词回复,支持函数调用、工具结果续接与 Google 搜索,用量计入 Build 对话额度(免费请求或 Google AI 订阅额度);每个账户使用一个 Build 应用,同一段对话在应用中续接,服务重启后照常续接。⚠️ 这类模型的每次请求都带有 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、Antigravity CLI 的文件读写工具调用,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 官网中隐藏,官网选中后只显示示例应用,本服务可以直接使用 - YouTube 输入: YouTube 视频 URL 作为外部视频附件读取;开启
YOUTUBE_LINKS后,消息文本中的 YouTube 链接同样作为视频读取 - 视频理解设置: Gemini 与 Interactions 支持逐视频的起止时间、0–24 FPS 范围内的正数采样率和静态/Agentic 处理;Agentic 返回服务端处理步骤并支持历史续接
- 智能模型切换: 从 AI Studio 实时发现模型并按
model字段路由;开启DISCOVER_HIDDEN_MODELS后,AI Studio 官网尚未公开的模型在确认账户能用后也会加入模型列表 - 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 安装时由系统弹出管理员认证;新版本 1 分钟内没有启动时,浏览器中的管理页面提示重新打开程序与日志位置
- 模块化架构: 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.3+、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
从 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.2/spidermonkey-v158.0.1-aistudio2api.2-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.exex86_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 从 Releases 下载 darwin-universal.dmg,打开后把 AIStudio2API.app 拖入“应用程序”。应用使用 ad-hoc 签名,首次打开被系统拦截时,在“系统设置 → 隐私与安全性”中点击“仍要打开”,或执行:
xattr -dr com.apple.quarantine /Applications/AIStudio2API.appmacOS 版关闭窗口后在菜单栏继续运行:单击菜单栏图标显示窗口,右键打开菜单,点 Dock 图标或从“应用程序”再次打开时显示窗口。
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。
- Go 1.27.3 或更高版本
- Node.js 22.18+、24.11+ 或 26+,以及配套 npm
- C/C++ 编译器:macOS 为 Xcode Command Line Tools,Linux 为 Zig 0.16
git clone https://github.com/Mag1cFall/AIStudio2API.git
cd AIStudio2API
cp .env.example .envcd 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/v158.0.1-aistudio2api.2/spidermonkey-v158.0.1-aistudio2api.2-$platform-$arch.tar.gz | tar -xz -C spidermonkey
mkdir -p libwebp
curl -L https://github.com/Mag1cFall/libwebp/releases/download/v1.6.0-aistudio2api.1/libwebp-v1.6.0-aistudio2api.1-$platform-$arch.tar.gz | tar -xz -C libwebp
export CGO_CPPFLAGS="-I$PWD/spidermonkey/include -I$PWD/libwebp/include" CGO_LDFLAGS="-L$PWD/spidermonkey/lib -L$PWD/libwebp/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
./aistudio2apiLinux 与 macOS 同样在需要时自动准备对应平台的 Camoufox。
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与账户代理从容器内访问,代理运行在宿主机时填写宿主机的局域网地址,并允许代理接受局域网连接- 容器时区为 UTC,日志时间与用量页的按日统计取容器时区,在
docker-compose.yml中加入environment: { TZ: <IANA 时区> }改用其他时区;新账户的语言与时区按出口 IP 的地理位置填写,也可在账户页单独设置 - 修改
data/.env后执行docker compose restart;更新镜像执行docker compose pull && docker compose up -d;在源码目录中执行docker compose up -d --build从源码构建
-
启动程序:
- Windows 双击
aistudio2api.exe - macOS 与 Linux 桌面版从应用程序启动,命令行版运行
./aistudio2api - 桌面版在窗口中打开管理页面,命令行版在浏览器中打开
http://127.0.0.1:2048 - 页面初始状态为
STOPPED,默认显示“日志”页面
- Windows 双击
-
添加首个账户: 在“账户”页面点击“添加账户”
-
启动 API:
- 点击“启动服务”启动数据面
- 状态依次显示
LAUNCHING和RUNNING;LAUNCHING期间可以点击“停止服务”取消启动 - 在“日志”页面确认账户、模型和请求状态
- API 默认监听
http://127.0.0.1:2048
-
发出请求: 按 API 使用 配置客户端
更多账户同样在“账户”页面添加,各种添加方式、账户状态与可用操作见 账户管理。
- 桌面版双击
aistudio2api.exe或从应用程序启动;命令行版运行./aistudio2api - 点击“启动服务”启用 API;设置
AUTO_START=true后,程序启动时自动启动服务;启动与停止期间侧栏显示当前步骤与已用时间 - 点击“停止服务”会取消正在进行的启动或活动请求并关闭 WAA Worker,管理页面与日志保持可用
- 再次点击“启动服务”即可恢复 API
设置的生效时机:
- 保存后立即生效:账户选择策略、Worker 容量、换号次数上限、模型映射、非流式保活、假流式、搜索型号、全模型搜索与媒体输出;进行中的请求沿用开始时的设置
- 停止再启动生成服务后生效:其余生成服务配置,启动时读取最新
.env - 重启管理进程后生效:管理页面地址、预览地址和
PROXY_API_KEY
退出程序:
- 桌面版关闭窗口后在系统托盘继续运行,从托盘菜单“退出”结束管理进程
- 命令行版在启动窗口按
Ctrl+C或关闭窗口会退出整个管理进程;关闭浏览器标签页不会停止管理进程
Windows 桌面版在命令行中运行以下命令时写作 cmd /c start /wait aistudio2api.exe <参数>,命令行等程序结束后返回。
aistudio2api:启动管理进程并打开管理页面,桌面版打开窗口,命令行版打开网页。
aistudio2api -open-ui=false:启动管理进程但不打开窗口或网页,桌面版只显示托盘图标。
aistudio2api setup:导入账户。
- 不带参数时扫描本机 Chrome 账户,
--email或--profile选择明确的 Chrome 账户 --locale、--timezone指定账户的语言与时区,省略时按出口 IP 的地理位置填写- 隔离登录:
aistudio2api setup --login,需要图形界面;没有图形界面时启动服务,在管理页面的“浏览器登录”中登录 - 文件导入:
aistudio2api setup --storage-state <file> - Cookie 导入:
aistudio2api setup --cookie-file <file>、aistudio2api setup --cookie "<Cookie 请求头>"或aistudio2api setup --cdp <调试地址>- 账户邮箱按 Cookie 识别,
--cdp导入的账户沿用该浏览器的语言与时区 - Cookie 来自同时登录多个 Google 账户的浏览器时,以
--authuser N选择官网地址/u/N/中第 N 个账户
- 账户邮箱按 Cookie 识别,
aistudio2api setup --remote https://<远程实例>:向远程实例添加账户。
- 在远程实例的账户页点击“远程添加”,对话框给出完整命令,一键复制后在能登录 Google 的电脑上运行:Windows 为
cmd /c start /wait aistudio2api.exe setup --remote <地址> --token <令牌>,其他系统为./aistudio2api setup --remote <地址> --token <令牌> - 账户来源可选“该电脑 Chrome 中的账户”或“在新窗口登录”(命令带
--login) - 省略
--token时运行后从标准输入读取令牌 - 对话框打开期间沿用仍有效的令牌,令牌到期时自动换新;点击“换一个令牌”立即换新,旧令牌随即失效
- 从该电脑 Chrome 导入的账户只能由这台电脑续签:命令上传这类账户后留在前台,立即并每 100 分钟向远程实例发送它们的新会话,失败时 5 分钟后重试;远程实例已删除账户或续签凭据失效时停止为该账户续签
- 保持该窗口打开;重启电脑后运行
aistudio2api setup --remote <地址> --renew恢复续签
服务启动后,可以直接使用 OpenAI Chat Completions:
curl http://127.0.0.1:2048/v1/chat/completions \
-H "Authorization: Bearer 123" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.8-flash",
"messages": [{"role": "user", "content": "Hello, world!"}],
"stream": true
}'| 协议 | Base URL | API key |
|---|---|---|
| OpenAI Chat / Responses | http://127.0.0.1:2048/v1 |
.env 中的 PROXY_API_KEY |
| Anthropic Messages | http://127.0.0.1:2048 |
.env 中的 PROXY_API_KEY |
| Gemini | http://127.0.0.1:2048 |
.env 中的 PROXY_API_KEY |
模型名称从 GET /v1/models 或 GET /v1beta/models 读取。
PROXY_API_KEY为空时,浏览器中只有本机页面可以直接调用接口;网页版客户端和部分桌面客户端需要设置PROXY_API_KEY- 多个 key 用逗号分隔,任一 key 都可调用;设置页可为每个 key 勾选处理其请求的账户
- 请求带
X-AIStudio-Account: <账户>请求头时只由该账户处理,账户填账户页显示的邮箱;该账户出错时直接返回它的错误,不换到其他账户
以 Cherry Studio 为例:
- 打开 Cherry Studio 设置
- 新增 OpenAI 兼容提供商
- API 主机地址填写
http://127.0.0.1:2048/v1 - API 密钥填写
.env中的PROXY_API_KEY - 从
/v1/models获取模型,或手动添加gemini-3.8-flash、gemini-3.5-flash-lite
Claude Code 使用 Anthropic 接口,子 Agent 按 opus、sonnet、haiku 档位选择模型,以下变量把它们映射到 AI Studio 模型;WebSearch 由 Google Search 执行:
$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:2048"
$env:ANTHROPIC_API_KEY = "<PROXY_API_KEY>"
$env:ANTHROPIC_MODEL = "gemini-3.8-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "gemini-3.1-pro-preview"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "gemini-3.8-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "gemini-3.5-flash-lite"Codex 使用 Responses 接口,在 ~/.codex/config.toml 中添加 provider,并把 PROXY_API_KEY 写入 AISTUDIO2API_KEY 环境变量;Codex 的 web_search 工具由 Google Search 执行:
model = "gemini-3.8-flash"
model_provider = "aistudio"
[model_providers.aistudio]
name = "AIStudio2API"
base_url = "http://127.0.0.1:2048/v1"
env_key = "AISTUDIO2API_KEY"
wire_api = "responses"omp 的 web_search 工具使用 web 角色的模型搜索。在 omp 的 models.yml 中添加指向本服务的 Gemini provider(apiKey 为保存 PROXY_API_KEY 的环境变量名),并在 config.yml 中把 web 角色设为该模型:
# models.yml
providers:
aistudio-gemini:
baseUrl: http://127.0.0.1:2048/v1beta
api: google-generative-ai
apiKey: AISTUDIO2API_KEY
models:
- id: gemini-3.8-flash# config.yml
modelRoles:
web: aistudio-gemini/gemini-3.8-flashAntigravity CLI(agy)使用 Gemini 接口。在 ~/.gemini/antigravity-cli/settings.json 中写入 {"modelProvider": "gemini"},设置以下环境变量后运行 agy,模型在 agy 中用 /model 选择:
$env:GEMINI_API_KEY = "<PROXY_API_KEY>"
$env:GOOGLE_GEMINI_BASE_URL = "http://127.0.0.1:2048"
agy主要端点:
| 能力 | 端点 |
|---|---|
| 模型 | GET /v1/models、GET /v1/models/{model}、GET /v1beta/models、GET /v1beta/models/{model} |
| OpenAI Chat | POST /v1/chat/completions |
| OpenAI Responses | POST /v1/responses、POST /v1/responses/input_tokens、POST /v1/responses/compact、GET/DELETE /v1/responses/{id}、GET /v1/responses/{id}/input_items、POST /v1/responses/{id}/cancel |
| Files | POST /v1/files、GET /v1/files、GET /v1/files/{id}、GET /v1/files/{id}/content、DELETE /v1/files/{id}(OpenAI 与 Anthropic 格式);POST /upload/v1beta/files、GET /v1beta/files、GET/DELETE /v1beta/files/{id} |
| Anthropic | POST /v1/messages、POST /v1/messages/count_tokens |
| Gemini | POST /v1beta/models/{model}:generateContent、:streamGenerateContent、:countTokens;POST/GET /v1beta/cachedContents、GET/PATCH/DELETE /v1beta/cachedContents/{id} |
| Embeddings | POST /v1/embeddings、POST /v1beta/models/{model}:embedContent、:batchEmbedContents |
| 图片 | POST /v1/images/generations、POST /v1/images/edits、Imagen POST /v1beta/models/{model}:predict |
| 语音 | POST /v1/audio/speech |
| 转录与翻译 | POST /v1/audio/transcriptions、POST /v1/audio/translations |
| 音乐 | Gemini generateContent + responseModalities: ["AUDIO"] |
| 视频 | POST /v1/videos、GET /v1/videos、GET/DELETE /v1/videos/{id}、GET /v1/videos/{id}/content |
| Gemini 视频 | POST /v1beta/models/{model}:predictLongRunning、GET /v1beta/operations/{id} |
| Live(含实时翻译、实时转录与实时音乐)/ Robotics | GET /v1/live、GET /v1/robotics/stream |
Gemini 的 /v1beta 路径在 /v1 下同样可用,Google Gen AI SDK 3.x 默认使用 /v1。/v1/models 与 /v1/files 的请求带 x-goog-api-key 请求头或 key 参数且不带 Authorization 时按 Gemini 格式返回,其余按 OpenAI 格式返回。
四套生成接口均可按各自协议字段启用 Search、Image Search、URL Context、Code Execution 和 Maps。Files、Transcribe、Live、Robotics 的请求与事件格式见 Google AI Studio 协议规范。
生成请求中的内联附件:
- 优先上传到生成账户的 Drive,之后带相同附件的请求优先发往已上传该附件的账户并直接引用已上传的文件,闲置 1 小时后删除
- 账户未授予 Drive 权限或存储配额不足时保持内联数据发送
- 图片、音频、视频、PDF 等输入需要所选模型支持
- 重复使用的附件可通过 Files 接口上传一次并复用文件 ID
附件字段与编码:
- Gemini 附件与视频图片输入支持
inlineData/inline_data、fileData/file_data、mimeType/mime_type和fileUri/file_uri - 媒体 Base64 数据支持标准与 URL-safe 字母表、带填充与无填充形式,以及
data:<MIME>;base64,前缀;OpenAI 助手历史中的 Markdown 图片同样支持 URL-safe Base64 和 CR/LF 换行 - 内联 GIF 和视频表单上传的 GIF 按首帧静态图片转换为 PNG,保留逻辑画布、帧位置与透明背景;经 Files API 上传的 GIF 按首帧转换为白底 JPEG
TalkifyTTS 与新版 Google Gen AI SDK 可连接 http://127.0.0.1:2048/v1beta/interactions,稳定版入口为 /v1/interactions。请求使用 x-goog-api-key,支持 gemini-3.8-flash-tts 与 gemini-3.8-flash-lite-tts:
from google import genai
client = genai.Client(api_key="123", http_options={"base_url": "http://127.0.0.1:2048"})
stream = client.interactions.create(
model="gemini-3.8-flash-tts",
input="Hello, this is a test.",
response_format={"type": "audio"},
generation_config={"speech_config": [{"voice": "Kore"}]},
stream=True,
)
for event in stream:
if event.event_type == "step.delta" and event.delta.type == "audio":
print(event.delta.data)流式音频默认为 Base64 编码的 24 kHz、16-bit 小端、单声道 PCM;非流式默认为完整 WAV,通过 interaction.output_audio.data 读取。response_format.mime_type 可显式选择 audio/l16 或 audio/wav。风格与多说话人输入见 Interactions 协议。
curl http://127.0.0.1:2048/v1/audio/speech \
-H "Authorization: Bearer 123" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.8-flash-tts",
"input": "Hello, this is a test.",
"voice": "Kore",
"response_format": "wav"
}' \
--output speech.wav多说话人语音可以通过 Gemini generateContent 的 multiSpeakerVoiceConfig 配置。
curl http://127.0.0.1:2048/v1beta/models/gemini-2.5-flash-preview-tts:generateContent \
-H "x-goog-api-key: 123" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "Joe: How are you?\nJane: I am fine, thanks!"}]}],
"generationConfig": {
"responseModalities": ["AUDIO"],
"speechConfig": {
"multiSpeakerVoiceConfig": {
"speakerVoiceConfigs": [
{"speaker": "Joe", "voiceConfig": {"prebuiltVoiceConfig": {"voiceName": "Kore"}}},
{"speaker": "Jane", "voiceConfig": {"prebuiltVoiceConfig": {"voiceName": "Puck"}}}
]
}
}
}
}' --output speech.json- 可用语音由实时模型目录中的
capability_options.voices返回 gemini-3.8-flash-tts等带speech_metadata能力的模型同样接受上面的说话人: 台词写法,也可以为每个文本 part 设置speechMetadata.speaker与speechMetadata.style,并用multiSpeakerVoiceConfig.mode选择VERBATIM或CONVERSATIONAL- OpenAI
instructions在这些模型上作为语音风格
curl http://127.0.0.1:2048/v1/images/generations \
-H "Authorization: Bearer 123" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-nano-banana-2.1",
"prompt": "A cute cat wearing a tiny hat",
"n": 1,
"size": "1024x1024"
}'size为输出图片的宽高,例如2560x1440:服务按最接近的宽高比与能覆盖该尺寸的分辨率生成后缩放为该尺寸size为auto或省略时,quality的low、medium、high分别按 1K、2K、4K 生成output_format取png(默认)、jpeg或webp/v1/images/edits与 Responses 的image_generation工具使用同样的字段,Gemini 原生接口使用imageConfig.aspectRatio与imageConfig.imageSize
curl http://127.0.0.1:2048/v1/videos \
-H "Authorization: Bearer 123" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-omni-1.2-flash",
"prompt": "A drone flying over a forest"
}'创建任务后通过 GET /v1/videos/{id} 查询状态,通过 GET /v1/videos/{id}/content 下载结果;gemini-omni-1.2-flash 等能输出视频的 Omni 模型同样经 :predictLongRunning 创建任务。
curl http://127.0.0.1:2048/v1beta/decisions \
-H "x-goog-api-key: 123" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-decision-1",
"input": "I was charged twice for my order.",
"questions": {
"is_refund": {"type": "noul", "instructions": "Is the customer asking for money back?"},
"department": {
"type": "choice",
"instructions": "Which department should handle this request?",
"criteria": {"billing": "Payments and refunds.", "shipping": "Delivery and tracking.", "other": ""}
}
}
}'questions的键由调用方命名,回答按同样的键返回,每个回答都带confidencenoul:返回为真的概率noul,criteria可写true_description与false_descriptionchoice:criteria为选项 ID 到说明,返回choice与各选项的probabilitiesscore:criteria为从低到高的等级说明,返回期望等级score、各等级的probabilities与legendinput接受字符串或 Interactions 内容块,图片、音频、视频与 PDF 以data(Base64)或uri(HTTPS 链接或本服务 Files API 的文件)给出并写明mime_type- Google Gen AI SDK 以
client.decisions.create调用
gemini-decision-1 在 AI Studio 官网中隐藏:官网 Playground 选这个模型时只显示示例应用,不能直接对话;本服务可以直接使用,每次使用在运行日志中提醒。
模型目录会随 AI Studio 更新,客户端从 /v1/models 或 /v1beta/models 读取当前值。下表为目录中的常用模型,模型 ID 与上限以运行时结果为准:
| Model ID | 名称 | 类型 | 输入 | 输出 |
|---|---|---|---|---|
gemini-4-hydrogen |
Gemini 4 Hydrogen | 文本 | 1048576 | 65536 |
gemini-4-carbon |
Gemini 4 Carbon | 文本 | 1048576 | 32768 |
gemini-4-neon |
Gemini 4 Neon | 文本 | 1048576 | 65536 |
gemini-4-argon |
Gemini 4 Argon | 文本 | 1048576 | 32768 |
gemini-3.8-flash |
Gemini 3.8 Flash | 文本 | 1048576 | 65536 |
gemini-3.5-flash-lite |
Gemini 3.5 Flash Lite | 文本 | 1048576 | 65536 |
gemma-4-31b-it |
Gemma 4 31B IT | 文本 | 262144 | 32768 |
gemini-omni-1.2-flash |
Gemini Omni 1.2 Flash | 文本与视频 | 131072 | 65536 |
deep-research-preview-04-2026 |
Deep Research Preview | 深度研究 | 1048576 | 65536 |
deep-research-max-preview-04-2026 |
Deep Research Max Preview | 深度研究 | 1048576 | 65536 |
gemini-decision-1 |
Gemini Decision 1 | 决策 | 262144 | 1 |
gemini-nano-banana-2.1 |
Nano Banana 2.1 | 图片 | 65536 | 65536 |
gemini-3.1-flash-lite-image |
Nano Banana 2 Lite | 图片 | 65536 | 65536 |
gemini-3-pro-image |
Nano Banana Pro | 图片 | 131072 | 32768 |
gemini-3.8-flash-tts |
Gemini 3.8 Flash TTS | 语音合成 | 8192 | 16384 |
gemini-3.8-flash-lite-tts |
Gemini 3.8 Flash Lite TTS | 语音合成 | 8192 | 16384 |
gemini-3.5-transcribe |
Gemini 3.5 Transcribe | 转录 | 98304 | 32768 |
lyria-3.5 |
Lyria 3.5 | 音乐 | 1048576 | 65536 |
lyria-3-pro-preview |
Lyria 3 Pro Preview | 音乐 | 1048576 | 65536 |
gemini-3.8-live |
Gemini 3.8 Live | 实时对话 | 131072 | 65536 |
gemini-3.5-live-translate-preview |
Gemini 3.5 Live Translate Preview | 实时翻译 | 16384 | 32768 |
目录中另有 -latest 别名、Robotics-ER、Gemini 3 系列与早期版本的图片、TTS、Live 模型,各文本与图片模型带 Google 搜索的 -search 变体,以及 Build 通道的 -build 模型。Genie 4(genie-4)只对开通计费的 API key 开放,列在目录中、不含 channels。
公开端点实现标准 generateContent、countTokens、embedContent、batchEmbedContents、predictLongRunning 和 createDecision(/v1beta/decisions);bidiGenerateContent 与 bidiGenerateMusic 模型经 /v1/live 调用。/v1/models 与 /v1beta/models 原样汇总各账户实时上游目录;调度按目录明确提供的模型 ID、方法、能力字段和账户当前运行状态选择账户。
- 启用账户的订阅都不满足的模型(如只对 Google AI Ultra 开放的模型)同样列在目录中、不含
channels,调用时返回 403 并写明所需订阅 - 能力含
output_continuation的模型(如 Gemini 4 Argon)与官网一样接受到input_token_limit的输出上限:未指定输出上限时取input_token_limit,超过 32768 时分轮自动续写,各轮输出合并为一个响应 - 模型名可以带思考后缀,例如
gemini-4-argon(low):括号内为none、minimal、low、medium、high、xhigh、extra_high、max、auto或思考预算 token 数,后缀优先于请求体中的思考参数 - 客户端写死的模型名可用
MODEL_MAPPING映射到目录中的模型,例如MODEL_MAPPING=claude-haiku-5-5:gemini-3.8-flash,别名以目标模型的字段列在模型目录中
AIStudio2API/
├── cmd/aistudio2api/ # 程序入口与 Windows 资源
├── internal/
│ ├── app/ # 命令、管理监听、生成服务生命周期与调度
│ ├── config/ # .env 配置项的读取与校验
│ ├── setup/ # 账户导入和独立登录 CLI
│ ├── aistudio/ # AI Studio 协议、认证、模型与媒体
│ ├── api/ # OpenAI、Responses、Anthropic 与 Gemini 适配
│ ├── waa/ # SpiderMonkey WAA 运行时
│ ├── camoufoxnative/ # Camoufox BiDi、登录与 WAA Worker
│ ├── chromeauth/ # Windows Chrome 与 DBSC 导入
│ ├── proxydial/ # 全局与账户代理的拨号与转发
│ ├── sqlitedb/ # 本地 SQLite 数据库
│ ├── requestdb/ # 请求用量、汇总与正文账本
│ ├── promptdb/ # API 试用页对话存储
│ ├── pricing/ # 用量页费用估算
│ ├── i18n/ # 服务文案的界面语言翻译
│ ├── webui/ # 内嵌前端产物
│ └── desktop/ # 桌面窗口与系统托盘
├── web/ # Vue 3 + TypeScript 前端
│ └── src/
│ ├── playground/ # API 试用页
│ ├── components/ # 管理页面组件
│ └── locales/ # 界面语言
├── docs/ # 构建、开发、协议、日志与 WAA 文档
├── build/ # 应用图标与各平台打包配置
├── .github/workflows/ # 检查、五平台构建与 Release 发布
├── .env.example # 配置模板
├── Dockerfile # Docker 镜像
├── docker-compose.yml # Docker Compose 示例
├── go.mod # Go 模块与依赖
└── LICENSE
运行时在程序目录生成 .env、auth/(账户认证材料)与 runtime/(Camoufox、本地数据库、日志与媒体文件)。
复制并编辑环境配置文件:
cp .env.example .env进程环境变量覆盖 .env 中的同名项,这些项在设置页中不可修改;在管理页面保存设置时 .env 写入 WAA 后端与其余和默认值不同的项;取值无效的项按默认值运行,并在管理页面顶部与日志中列出。
| 变量 | 默认值 | 作用 |
|---|---|---|
AISTUDIO_AUTH_STATES |
auth |
账户文件、目录或多个逗号分隔路径 |
LISTEN_ADDR |
127.0.0.1:2048 |
管理页面与 API 监听地址 |
PREVIEW_LISTEN_ADDR |
127.0.0.1:2050 |
API 试用页 HTML 预览的监听地址,端口与 LISTEN_ADDR 不同 |
PROXY_API_KEY |
空 | 公开 API key |
API_KEY_ACCOUNTS |
空 | 各 key 可用的账户,每项写成 key:账户|账户,未列出的 key 可用全部账户;也可在设置页按 key 勾选账户,保存后立即生效 |
AUTO_START |
false |
管理程序启动后自动启动生成服务 |
HIDE_DOCK_ICON |
false |
macOS 桌面版只在菜单栏显示图标、不显示 Dock 图标,关闭窗口后服务继续运行;在设置页修改立即生效 |
REQUEST_BODY_LOG |
false |
保存公开 API 请求与响应正文,各截断到 64 KiB,保留最近 1000 条 |
LOG_FILE |
true |
同时把服务日志写入 runtime/logs/,单文件 10 MB 轮转 |
LOG_MAX_TOTAL_MB |
500 |
日志目录总量上限,超出时删除最旧的文件,不小于 20 |
ADMIN_AUTH_ENABLED |
false |
管理控制台账号密码登录开关 |
ADMIN_USERNAME |
admin |
管理员账号 |
ADMIN_PASSWORD |
空 | 管理员密码,开启登录时必填 |
PROXY |
空 | Chrome 导入、登录和账户默认使用的 HTTP、HTTPS 或 SOCKS5 代理,多个代理用逗号分隔组成代理池;留空时使用系统代理 |
INIT_TIMEOUT |
2m |
单账户 WAA 初始化超时 |
REQUEST_TIMEOUT |
30m |
单次请求最大执行时间,自动续写的每一轮开始时重新计时 |
WARM_WORKER_LIMIT |
10,Camoufox 后端 5 |
常驻预热账户数 |
MAX_ACTIVE_WORKERS |
20,Camoufox 后端 10 |
高峰期最多同时运行的 Worker 数 |
WARM_STARTUP_CONCURRENCY |
5 |
按需扩容时同时冷启动的 Camoufox Worker 数,预热逐个启动;WAA_BACKEND=spidermonkey 时不限制 |
PER_ACCOUNT_CONCURRENCY |
2 |
单账号同时执行的请求数 |
ROUTING_STRATEGY |
round-robin |
round-robin 轮询;fill-first 账号粘性优先 |
ACCOUNT_ORDER |
空 | fill-first 依次使用的账户,逗号分隔,未列出的账户排在后面并按 ID 排序;也可在设置页调整,保存后立即生效 |
MAX_ACCOUNT_SWITCHES |
3 |
上游返回 403、5xx 等非额度错误时一个请求最多换几次账户重试,0 为不换号 |
UPSTREAM_CHANNELS |
playground |
生成请求使用的上游通道,playground、build 逗号分隔;build 为旧通道,上游已停用其生成 |
MODEL_MAPPING |
空 | 客户端模型名到目录模型的映射,每项写成 别名:模型 ID,逗号分隔多项 |
MODEL_CHANNELS |
空 | 限定模型只走一个通道,每项写成 模型 ID:playground 或 模型 ID:build;也可在“模型目录”的模型详情中选择,保存后立即生效 |
MODEL_ACCOUNTS |
空 | 模型可用的账户,每项写成 模型 ID:账户|账户,未列出的模型可用全部账户;也可在“模型目录”的模型详情中勾选,保存后立即生效 |
BUILD_NATIVE_NONSTREAM |
true |
启用 Build 通道时非流式请求优先使用 Build 原生单次调用;不可用时回退流式并记录原因 |
NONSTREAM_KEEPALIVE |
true |
非流式请求等待结果超过 10 秒时先返回 200 并定时写出换行保持连接 |
FAKE_STREAM |
false |
流式请求先按非流式取得完整结果再按流式格式输出,中途失败时换号重发,等待期间照常发送心跳 |
YOUTUBE_LINKS |
false |
用户消息文本中的 YouTube 链接作为视频发送给模型,并从文本中移除 |
STRIP_THOUGHT_SIGNATURES |
false |
发往上游前去掉对话历史中的思考签名 |
SEARCH_MODEL_ALIASES |
true |
提供支持搜索的模型的 -search 型号,使用该型号时启用 Google 搜索 |
DISCOVER_HIDDEN_MODELS |
false |
同步账户模型目录时找出 AI Studio 官网尚未公开的模型并加入目录 |
GOOGLE_SEARCH |
false |
为 OpenAI、Anthropic、Gemini 与 Interactions 的生成请求启用 Google 搜索,包含普通型号与携带函数工具的请求 |
CONTINUATION_REWRITE |
true |
以 assistant 消息结尾的请求在不支持原生续写的模型上改写为续写请求;关闭时所有模型原样发送,上游拒绝时返回其错误 |
CONTINUATION_PROMPT |
内置英文续写句 | 改写时与末尾 assistant 消息一起写入系统指令的提示词;设为空时末尾 assistant 消息改作 user 消息发送 |
FIRST_EVENT_HEDGE |
off |
原请求迟迟没有首字时用空闲账户发起一个备用请求,取值 off、auto 或等待秒数 |
FIRST_EVENT_HEDGE_MODELS |
gemini-4-argon |
发起备用请求的模型 ID,逗号分隔;备用请求同样计入账户额度 |
WAA_BACKEND |
spidermonkey |
WAA 运行的位置,spidermonkey 或 camoufox |
MEDIA_OUTPUT |
inline |
Chat Completions 与 Messages 正文中生成图片与音频的引用方式,inline 或 url |
MEDIA_BASE_URL |
空 | 媒体 URL 使用的服务地址,例如 https://ai.example.com;留空时使用每个请求访问的地址,经反向代理时跟随 X-Forwarded-Proto |
补充说明:
PREVIEW_LISTEN_ADDR:无法监听时改用同一主机上的空闲端口;页面以当前访问的主机名加实际端口打开预览AUTO_START:网络等原因启动失败时按 5 秒起、翻倍至 5 分钟的间隔重试,手动启动或停止后不再重试MAX_ACCOUNT_SWITCHES:额度用尽不计入,照常依次尝试其余账户NONSTREAM_KEEPALIVE:返回 200 后每 10 秒写出一个换行直到写出 JSON 正文,经 Cloudflare 等反向代理时连接不会因长时间无数据断开;此后才出现的错误以协议错误正文返回STRIP_THOUGHT_SIGNATURES:函数调用带skip_thought_signature_validator;之前各轮的思考内容不随签名发给模型,长对话的输入 token 较少DISCOVER_HIDDEN_MODELS:- 在同步账户模型目录时探测:启动、每 24 小时与账户页“刷新全部”
- 确认账户能用的模型加入目录,可直接用于各协议请求并列在
/v1/models中,“模型目录”页标为“官网隐藏” - 官网公开后改用官网的模型信息;关闭后下一次启动生成服务时从目录中移除
FIRST_EVENT_HEDGE:- 备用请求优先用其他账户,没有时用原账户的空闲槽位;先出首字的一方继续,另一方取消
auto按各模型与通道近 24 小时首字等待的 p95,请求少于 20 次的模型与通道不发起- 正整数为等待秒数,设置页选自定义时填入请求最多的模型的近期 p95
WAA_BACKEND:spidermonkey在服务进程内的 SpiderMonkey 中运行 WAA,不下载也不启动 Camoufox;camoufox在 Camoufox 页面运行 WAA;其他取值按spidermonkey- 未设置时,启动时按
auth/确定后写入.env:已有账户而没有auth/.waa-interpreters时为camoufox,否则为spidermonkey
MEDIA_OUTPUT:inline以 data URI 内联url按内容命名保存到runtime/media/,以本服务的/media/<文件名>URL 引用,该路径不校验 API key;目录总量超过 1 GB 时从最久未使用的文件开始删除
服务启动时载入 AISTUDIO_AUTH_STATES 中的全部账户,容量由四项控制,在管理页面保存后立即作用于后续调度:
WARM_WORKER_LIMIT:常驻预热规模,调高时补足预热MAX_ACTIVE_WORKERS:峰值 Worker 上限,调低时关闭多出的空闲 WorkerWARM_STARTUP_CONCURRENCY:同时冷启动的 Camoufox Worker 数PER_ACCOUNT_CONCURRENCY:单账户请求槽位
管理控制台默认通过本机回环地址免密访问。远程管理时:
- 设置
ADMIN_AUTH_ENABLED=true、管理员账号和密码,重启程序后通过独立/login页面登录 - 登录会话有效期为 12 小时;勾选“30 天内保持登录”时为 30 天,程序重启后仍有效
- 支持退出登录,管理员共享同一个账户池、配置与日志
公开 API 使用独立的 PROXY_API_KEY。
反向代理使用 HTTPS,并保留原始 Host、设置 X-Forwarded-Proto: https。管理页“服务配置”可调整登录开关及凭据,保存后重启程序生效。
API 试用页的 HTML 预览运行在 PREVIEW_LISTEN_ADDR 提供的独立来源,页面以当前访问的主机名加该端口打开预览:
-
从其他电脑访问时,
PREVIEW_LISTEN_ADDR与LISTEN_ADDR一样监听可访问的地址 -
经反向代理访问时,在同一主机名的同一端口号上再代理到
PREVIEW_LISTEN_ADDR,例如管理页面为https://ai.example.com时,代理https://ai.example.com:2050到本机2050 -
管理页面与 API: 默认端口
2048 -
HTML 预览: 默认端口
2050 -
Camoufox: 由程序动态分配本机端口
支持通过 HTTP、HTTPS 或 SOCKS5 代理访问 AI Studio,代理需要认证时在 URL 中填写账号密码,例如 socks5://user:password@host:1080:
- 在“服务配置”中设置全局代理;留空时使用系统代理,先读
HTTPS_PROXY环境变量,未设置时读 Windows 或 macOS 的系统代理设置,代理输入框下方显示当前生成服务实际使用的出口 - 全局代理可以填写多个,用逗号分隔组成代理池:
- 没有专用代理的账户固定绑定到绑定账户最少的可用代理,绑定写入账户状态,重启后不变
- 代理连续 3 次网络错误或定时检测失败时,其账户改绑到其他可用代理,检测恢复后重新参与分配
- “服务配置”列出各代理的状态与绑定账户数,账户卡片显示每个账户的出口
- 在“账户”页面编辑单个账户时可以设置账户专用代理
- 账户代理同时用于登录、WAA 与业务请求
- 带账号密码的代理由程序在本机回环地址提供无认证 SOCKS5 中转供 Camoufox 使用,账号密码不写入浏览器 profile;中转运行期间,本机其他进程也能经它使用该代理
“账户”页面的“添加账户”提供以下方式:
| 方式 | 账户来源 | 说明 |
|---|---|---|
| 从 Chrome 导入 | 本机 Chrome 中已登录的账户 | 可多选,Windows 可用 |
| 粘贴 Cookie | Cookie 扩展导出的 JSON、请求头中的 Cookie 一行或 Netscape cookies.txt | 自动识别其中登录的账户邮箱 |
| 从指纹浏览器导入 | 本机指纹浏览器与 Chromium 中已登录 AI Studio 的窗口 | 浏览器需开启远程调试 |
| 浏览器登录 | 独立的 Camoufox 窗口 | 登录后自动识别邮箱并授权 Google Drive |
| 远程添加 | 另一台能登录 Google 的电脑 | 见 命令 的 setup --remote |
添加过程:
- 账户代理、语言区域与时区在对话框的“更多设置”中填写;语言区域与时区留空时按出口 IP 的地理位置填写,查不到出口位置时用本机的语言区域与时区
- 添加与重新登录在服务端的任务中运行:提交后即可离开对话框,账户页上方逐个显示当前步骤、已用时间、结果与失败原因,关闭或刷新管理页面后任务继续
- 账户保存到
.env中AISTUDIO_AUTH_STATES指向的目录,保存后立即出现在列表中,模型数与权益在后台读取完成后显示 - Edge、Brave 等日常使用的浏览器用 Cookie 扩展(如 Cookie-Editor)在 aistudio.google.com 导出后粘贴,或选择 Cookie 文件
- 账户列表上方列出每个出口 IP 与经它访问 Google 的账户数,多个账户共用的出口 IP 以黄色标出,查询失败的出口以红色标出、悬停显示原因
浏览器登录:
- 在本机打开可见的 Camoufox 窗口;Google 要求验证身份时,在该窗口或手机上确认
- 服务器没有图形界面,或从其他电脑、经反向代理打开管理页面时,“浏览器登录”与“重新登录”的 Camoufox 在服务器上无头运行,画面显示在管理页面的全屏登录窗口中,在其中点击、输入与粘贴,点“取消”结束登录
- 页内登录窗口可以隐藏,之后从任务行再次打开;经反向代理访问时需要转发
/api/login-view/的 WebSocket
账户操作随状态显示,点击账户行的状态可把账户改为“就绪”或“已停用”:
| 账户状态 | 可用操作 |
|---|---|
ready |
编辑、停用、立即刷新、删除 |
disabled |
编辑、改为就绪、删除 |
cooldown |
编辑、改为就绪、停用、立即刷新、删除 |
auth_required |
编辑、改为就绪、停用、重新登录、立即刷新、删除 |
restricted |
编辑、改为就绪、停用、立即刷新、删除 |
- 改为就绪会启用已停用的账户,并清除服务受限、账户整体的冷却与需要登录的标记,各模型的冷却保留到恢复时间;账户仍被 Google 拒绝时,下一次请求把它标回原状态并换用其他账户
- 刷新、停用、启用与保存在进行时,账户行显示当前步骤与已用时间(等待几个请求结束、读取权益与模型目录、核对验证状态),日志页有同样的步骤与结果
权益与模型目录的读取:
- “刷新全部”立即读取全部启用账户的权益与模型目录,后台每 24 小时也会读取一次;请求的模型不在目录中且距上次读取超过 10 分钟时,服务先读取一次再处理该请求
- 从未读取成功的账户权益显示为未知,并显示最近一次失败原因;已有目录的账户读取失败时照常使用,账户行显示“目录同步失败”与原因
- 读取报告 AI Studio 不支持当前出口地区时,已有目录的账户同样显示该原因
服务受限(restricted):
- Google 限制账户使用 AI Studio、账户未满足 AI Studio 的年龄要求或所属 Workspace 没有开放 AI Studio 时,账户进入该状态并显示原因与官网页面链接
- 启动、调度与后台读取都跳过该账户,不续签
- 在官网完成验证后,把账户状态改为“就绪”或点“立即刷新”都能恢复:立即刷新只载入一次页面,读取成功后恢复
- 从 Chrome、Cookie 与指纹浏览器导入时,服务受限的账户标出原因且不能导入
认证文件默认存储在 auth/ 目录:
| 路径 | 内容 |
|---|---|
auth/<Google 邮箱>/account.json |
账户邮箱、代理、语言、时区和启用状态 |
auth/<Google 邮箱>/storage-state.json |
Google Cookie 与认证续签材料 |
auth/<Google 邮箱>/runtime-state.json |
权益等级、模型资格、冷却状态与资源所属账户 |
auth/<Google 邮箱>/camoufox-cache/ |
该账户浏览器的网页缓存与启动缓存,服务停止时可删除 |
auth/.leases/<Google 邮箱>.lock |
同一账户目录的跨进程占用锁 |
[用户缓存]/AIStudio2API/runtime-leases/<Google 邮箱>.lock |
当前电脑上该邮箱的 WAA Worker 占用锁 |
账户邮箱同时作为目录名、管理页面标识和日志来源,统一使用小写形式。.leases 协调账户目录读写,用户缓存中的 runtime lease 保证同一邮箱在当前电脑上只有一个 WAA Worker。
本项目使用 Camoufox 浏览器来降低被检测为自动化脚本的风险。Camoufox 基于 Firefox,通过修改底层实现来保持真实的设备指纹。
Go 负责编码、调度、流式解码与公开协议;WAA_BACKEND=camoufox 时,受 WAA 保护的 GenerateContent 通过账户固定指纹 Camoufox 页面发送,保留原生 Firefox TLS/HTTP2、请求头、Cookie 与页面指纹。
WAA_BACKEND=spidermonkey 时,WAA 在服务进程内的 SpiderMonkey 中运行,按账户指纹模拟 Firefox 页面环境并以 Firefox 请求头直接发送,运行时不下载也不启动 Camoufox。账户页的浏览器登录仍使用 Camoufox,首次登录时按需准备。
- 客户端管理历史: Chat、Anthropic 和 Gemini 请求由客户端提交完整对话上下文
- AI Studio 历史: API 请求不保存到官网历史
- Responses 会话:
previous_response_id与previous_interaction_id共用最多 256 个响应节点,保存在runtime/states.db,重启后仍可续接 - 认证有效期: Chrome 导入账户保留 OAuth 续签材料,续签在 Windows 上执行,Linux、macOS 与 Docker 中的 Chrome 导入账户失效后重新从 Windows 复制;其他账户失效时在账户页重新登录
欢迎提交 Issue 和 Pull Request!






