
Antigravity API Key 怎么获取?3 种方案实测
Google Antigravity 是一款 AI 编程 IDE,默认走 Google 账号 OAuth 授权,官方并不提供 API Key 入口。但你常遇到需要 API Key 的场景:升级后 OAuth 登录失效、服务器没有浏览器、想把免费配额反代成标准 API 给其他工具用。下面三条主流路径可在一小时左右跑完,反代方案会标注封号风险。
先说明:Antigravity 到底有没有官方 API Key
这不是简单刷个据,先讲清楚:Antigravity 的默认认证是浏览器 OAuth 授权,官方没有像 OpenAI 那样一键生成的「Antigravity API Key」。所以想拿到能交给其他工具调用的 Key,主流有三条路:
- CLIProxyAPI 反代,把本地会话凭据代理成标准 API,密钥由你控制。
- Antigravity-Manager 开源工具,把 Google/Anthropic 会话额度转成 OpenAI、Anthropic、Gemini 三种协议。
- 在 Google AI Studio 申请 Gemini API Key,配进 Antigravity 的识别、补全场景,官方免费通道。
前置准备
先备齐这几样,避免中途卡住:
- 一个正常 Google 账号,且已登录 Antigravity 并跑通过一次 OAuth 授权,本地才有可用凭据。
- 一台能启动 Antigravity 的机器(Win 安装细节看 Antigravity Win11 安装教程)。
- 想清楚第三方工具走哪种协议(OpenAI/Anthropic/Gemini),再选端点。
- 网络能访问 GitHub 与 Google,国内用户建议提前备代理。
社区工具默认把 Key 写成 sk-antigravity,安全关键在谁能连到你的本机端口,务必仅本机监听、勿暴露公网。
路径一:CLIProxyAPI 反代转 API
CLIProxyAPI 在本地把 Antigravity 会话代理成标准 API,适合自己控制密钥、偏好轻量的用户。先在 GitHub Releases 下载对应系统压缩包,解压到全英文无空格目录。然后改两处配置:
- Windows 找
~/cliproxyapi/config.yaml,macOS 找/opt/homebrew/etc/cliproxyapi.conf。 allow-remote按访问范围定;secret-key一定改成自己的密码。
启动:Windows 直接跑 exe,macOS/Linux 进 ~/cliproxyapi/ 后执行 ./cli-proxy-api。本地访问 http://localhost:8317/management.html 登录后台确认状态,建议打开使用统计,方便看每次调用消耗多少 tokens。

路径二:Antigravity-Manager 开源工具转标准 API
Antigravity Tools(lbjlaq/Antigravity-Manager)能管理多账号,把配额转成三种标准接口:
- OpenAI:
/v1/chat/completions,兼容绝大多数 AI 应用。 - Anthropic:
/v1/messages,支持 Claude Code CLI 的思维链与系统提示词。 - Gemini:支持 Google 官方 SDK 直接调用。
安装三选一:一是终端一键脚本(Windows 用 PowerShell 的 irm);二是 Docker 部署跑 -p 8045:8045,用 API_KEY、WEB_PASSWORD 环境变量控制鉴权;三是 GitHub Releases 手动下载安装包。接入时 Base URL 统一填 http://127.0.0.1:8045,OpenAI 协议再拼 /v1;它适合多账号配额自动切换,还能自动处理 429/401。

路径三:Google AI Studio 申请 Gemini Key
若只是给 Antigravity 的识别、补全、生图这些调 Gemini 的场景配 Key,就不用反代,走官方免费通道更省心,细节看Google AI 与 Gemini 保姆级教程。步骤:
- 打开 aistudio.google.com/apikey,用 Google 账号登录。
- 勾选同意服务条款。
- 左侧菜单找到「Get API」。
- 点「Create API key in new project」或选已有项目。
- 稍等几秒弹出密钥串,安全存好(一般只显示一次)。
拿回 Antigravity 的设置搜索「API Key」填入,Gemini 类模型填官方 Base URL 和你的 Key。手机端可参考Gemini 一键进入 Antigravity。这条路无反代风险、是官方后台,缺点只有 Gemini 并带免费速率限制;想用 Claude 侧模型或分额度给多账号,回路径一或路径二。

怎么验证跑通
对刚配好的 Base URL 和 Key,用 Python OpenAI SDK 或 curl 发一条「介绍一下你自己」,能返回正常文本就成了。同时去后台确认两点:请求确实带上了你的 Key;统计里本轮 tokens 在涨,说明链路真实在走。
常见报错速查
| 症状 | 常见原因 | 解法 |
|---|---|---|
| 授权成功但客户端没反应 | 回调端口被占或被浏览器拦截 | 检查 127.0.0.1 监听,解决端口冲突后重开 |
EADDRINUSE |
端口被占用 | 用 lsof/netstat 找出并停占用进程 |
| entitlement 校验失败 | 升级后凭据不满足新模型权限 | 重走 OAuth 或改用 API Key 方案 |
| 401 被拒 | Key 与 OAuth Token 混填冲突 | 只留一种凭证,清缓存重填 |
| 429 频繁 | 免费额度速率超限 | 换账号、开自动切换或限速重试 |
常见问题
Antigravity 升级后 OAuth 登录失效怎么办?
通常不是账号问题,而是本地凭据不满足新模型的权限校验,典型痕迹是 entitlement check failed。先校准系统时间和缓存再重走授权;无浏览器环境就直接用 API Key 方案,参考[升级后登录失效排查](https://www.ai345.info/ai-guide/antigravity-free-half-year-application-guide)。
Antigravity 到底有没有官方 API Key?
官方没有像 OpenAI 那样的 API 体系,默认走 Google OAuth 授权。社区方案是反代,把本地会话凭据反转成标准 API 才能交给其他工具调。
反代 Antigravity 会封号吗?
存在风险。反代本质是拿你的配额做高并发或多账号轮换,易触发 Google 风控。建议低频、低并发、个人自用,别拿去批量售卖;真被封,配额可能被回收。
服务器、CI 里没有浏览器,怎么用 API Key?
直接走 API Key 方案绕过浏览器授权:CLIProxyAPI、Antigravity-Manager 都不依赖图形界面,配置后用环境变量注入 Key(如 `ANTHROPIC_API_KEY=sk-antigravity`)即可调。
Google AI Studio 的 Gemini Key 能直接用于 Antigravity 吗?
能。AI Studio 给的 Gemini Key 可配进 Antigravity 的识别、补全场景,走官方后台通道、无反代风险。
反代默认 Key 是 sk-antigravity,安全吗?
这是默认示范值。真正的安全是只让服务监听本机(`127.0.0.1`)、把后台密码改成自己的 secret-key、不暴露公网,端口隔离比 Key 本身更重要。

京ICP备2024094994号-29