分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

Mag1cFall/AIStudio2API

AI 工程

把 Google AI Studio 网页能力封装成 OpenAI、Anthropic 或 Gemini 兼容接口,供现有客户端和 Agent 调用。

599
145
Go
MIT
创建于 1 年前

这个 Go 服务把 Google AI Studio 的网页协议转换成兼容 API,让已有的 OpenAI、Responses、Anthropic 与 Gemini 客户端无需改 SDK 就能调用。典型用法是:在管理页添加 Google 账户,点击启动服务,然后把客户端指向 http://127.0.0.1:2048,并配上 .env 里的 PROXY_API_KEY。它定位为代理/逆向实现,并非 Google 官方 API。

工作原理

Go 侧负责协议适配、调度和管理界面。需要受保护上游流程的请求会经由按账户固定的类浏览器环境发送:默认用 Camoufox,设置 WAA_BACKEND=spidermonkey 后改为服务进程内的 SpiderMonkey,运行时不下载也不启动浏览器。多账户可按 round-robin 轮询或 fill-first 粘性优先,配合常驻预热 Worker、并发槽位与高峰上限。模型目录来自上游实时发现,客户端看到的模型列表会随 AI Studio 更新。

能接入什么

主要价值是四套协议:OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini GenerateContent。README 给了 Claude Code、Codex、omp 的配置方式,编程 Agent 可以用各自原生协议访问,后端再映射到 Gemini 等模型。除文本外,还覆盖图片生成(Nano Banana)、视频(Veo/Omni)、TTS、转录、Embeddings、Files,以及 Live/Robotics 的 WebSocket 端点,各自有独立协议文档。

环境要求与安装路径

文档给出四条路径,前置条件不同。Windows 可下载 Release 包,通过桌面窗口添加账户;macOS 需要 12 或更高版本;Linux 桌面版需要 GTK 4 与 WebKitGTK 6.0,AppImage 另需 Camoufox 运行库。源码运行需要 Go 1.27+、Node.js 22.18+/24.11+/26+、C/C++ 编译器(Windows 用 llvm-mingw 的 UCRT clang,macOS 用 Xcode 命令行工具,Linux 用 Zig 0.16)以及对应平台的 SpiderMonkey 静态库。Docker 支持 linux/amd64 和 linux/arm64,把 .env、auth/ 和 runtime/ 放在 data/ 下。无图形界面的服务器实际应走源码或 Docker。

第一件实际工作是把可访问 AI Studio 的 Google 账户加进来:浏览器登录、Chrome 导入、粘贴 Cookie、从指纹浏览器导入或远程配对。服务器没有图形界面时,Camoufox 登录画面显示在管理页里。Chrome 导入的账户保留 OAuth 续签材料,续签只在 Windows 上执行;在 Linux、macOS 或 Docker 中失效后需再从 Windows 复制。被判定为当前出口地区或账户不支持的条目会保留失败原因。

使用前要清楚的边界

这不是 Google 官方 API,依赖 AI Studio 网页行为和反自动化机制,上游改动可能导致失效。README 明确说 Build 应用代理是旧通道,上游已对账户停用其生成(PROXY_GENERATION_DISABLED),且 -build 模型的每次请求都会带上 Build 代码助手自带的系统提示词;Build 用量计入 Build 对话额度。免费账户两个通道共用同一模型的每日请求次数。Responses 的 previous_response_id 仅保存在当前进程,重启后不保留。PROXY_API_KEY 为空时,只有本机浏览器页面可以免 key 调用,网页版和桌面客户端需要设置它。从其他机器打开管理页需要开启管理员认证。README 提到带密码代理不会被写入 Camoufox,但运行期间本机其他进程可以经无认证的本地中转使用该代理。

项目使用 MIT 许可证。账号资源、付费与是否符合 Google AI Studio 的使用规则由部署者自行判断,README 没有说明 Google 对这类代理的官方态度。

项目源码与说明

本文由 AI 根据项目 README 生成,更新于 2026年10月31日,以项目官方文档为准。