ZeroGravity:Antigravity 开源 API 代理工具

字节笔记本

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.6Claude Opus 4.6 (Thinking),默认模型
sonnet-4.6Claude Sonnet 4.6 (Thinking)
gemini-3-flashGemini 3 Flash,开发环境推荐
gemini-3.1-proGemini 3.1 Pro (High),实验性
gemini-3-pro-imageGemini 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
OpenAIhttp://localhost:8741/v1
Anthropichttp://localhost:8741

支持的 API 端点

  • POST /v1/chat/completions - OpenAI 兼容的聊天补全(支持流式)
  • POST /v1/responses - OpenAI Responses API
  • POST /v1/messages - Anthropic Messages API
  • POST /v1beta/models/{model}:{action} - 原生 Gemini v1beta
  • GET /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"}]
  }'

项目信息

注意事项

  • 默认端口为 8741,可在配置中修改
  • 项目源码已转为私有,但作者提供只读访问权限(可通过 Discussion 或 Telegram 申请)
  • 请遵守 Google 的使用条款,合理使用该工具
分享: