字
字节笔记本
2026年2月23日
ZeroGravity:Antigravity 开源 API 代理工具
ZeroGravity 是一个开源的 API 代理工具,专为 Google 的 Antigravity(Gemini 在 VS Code 中的 AI 助手)设计。它能够将 Antigravity 的 Gemini 访问转换为标准 OpenAI、Anthropic 和 Gemini 兼容的 API 格式,让开发者可以使用熟悉的 API 接口访问 Google 的先进 AI 模型。
与其他代理工具不同,ZeroGravity 的核心优势在于它能让请求看起来与真实的 Antigravity 会话完全一致,避免了被检测为"假请求"的风险。
核心特性
- 多协议兼容:支持 OpenAI、Anthropic 和原生 Gemini API 格式
- 真实流量模拟:请求行为与真实 Antigravity 会话无法区分
- 流式响应:支持 SSE 流式输出,实时获取生成内容
- Docker 一键部署:仅需两条命令即可完成部署
- 多模型支持:覆盖 Claude Opus/Sonnet、Gemini Pro/Flash 等主流模型
支持的模型
| 模型名称 | 说明 |
|---|---|
opus-4.6 | Claude Opus 4.6 (Thinking),默认模型 |
sonnet-4.6 | Claude Sonnet 4.6 (Thinking) |
gemini-3-flash | Gemini 3 Flash,开发环境推荐 |
gemini-3.1-pro | Gemini 3.1 Pro (High),实验性 |
gemini-3-pro-image | Gemini 3 Pro 图像生成 |
安装与部署
ZeroGravity 仅支持 Docker 部署,这是官方推荐的唯一运行方式。
前置要求
- Docker 和 Docker Compose 已安装
- 有效的 Antigravity refresh token(需从官方 Antigravity 应用中提取)
部署步骤
bash
# 1. 生成配置文件(docker-compose.yml + accounts.json)
zg docker-init
# 2. 启动代理服务
docker compose up -d
# 3. 验证服务状态
curl http://localhost:8741/health获取认证令牌
使用官方 CLI 工具提取 token:
bash
# 从 Antigravity 应用中提取 refresh token
zg extract重要提示:务必从官方 Antigravity 应用中提取令牌,不要使用第三方来源的 token。
使用方式
API 端点配置
根据你使用的客户端/SDK,配置对应的端点地址:
| 协议 | 端点地址 |
|---|---|
| Gemini (推荐) | http://localhost:8741/v1beta |
| OpenAI | http://localhost:8741/v1 |
| Anthropic | http://localhost:8741 |
支持的 API 端点
POST /v1/chat/completions- OpenAI 兼容的聊天补全(支持流式)POST /v1/responses- OpenAI Responses APIPOST /v1/messages- Anthropic Messages APIPOST /v1beta/models/{model}:{action}- 原生 Gemini v1betaGET /v1/models- 列出可用模型
测试示例
bash
# 使用 CLI 测试
zg test "say hi"
# 或使用 curl 测试 OpenAI 兼容接口
curl http://localhost:8741/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-flash",
"messages": [{"role": "user", "content": "hi"}]
}'项目信息
- GitHub: https://github.com/NikkeTryHard/zerogravity
- 协议: MIT
- Stars: 231+
- 源码状态: 已转为私有仓库,但二进制文件和 Docker 镜像持续发布
注意事项
- 默认端口为 8741,可在配置中修改
- 项目源码已转为私有,但作者提供只读访问权限(可通过 Discussion 或 Telegram 申请)
- 请遵守 Google 的使用条款,合理使用该工具
分享: