Open Design Docs

接入 Antigravity API

使用 Antigravity Manager / Antigravity Tools 反代出的 API 接入 Open Design。

如果你已经可以正常使用 Antigravity,也可以通过 Antigravity Manager / Antigravity Tools 把它反代成本机 API,再在 Open Design 里按 BYOK 模型服务接入。

这种方式的核心思路是:

Open Design -> 本机 API 地址 -> Antigravity Tools 反代服务 -> Antigravity

也就是说,Open Design 不直接读取 Antigravity 客户端界面,而是把请求发送到 Antigravity Tools 提供的本机 API 地址。

Antigravity Manager 的发布页在 GitHub:lbjlaq/Antigravity-Manager Releases。发布页中的应用名称可能显示为 Antigravity Tools,请按自己的系统下载对应安装包。

GLOSSARY / 术语说明

反代

反代是「反向代理」的简称。你可以把它理解为一个中转服务:Open Design 把请求发给本机的 Antigravity Tools,Antigravity Tools 再帮你转给 Antigravity。

这样做的好处是,Open Design 可以像连接普通模型 API 一样连接 Antigravity。只需要在 Open Design 里填写 API 协议、API Key、Base URL 和模型名称。

使用前,请确认 Antigravity 本身已可正常使用,且 Antigravity Tools 里的反代服务已启动。只安装软件但没有启动反代服务,Open Design 仍然会连接失败。

什么时候使用

适合这种方式的情况:

  • 你已经可以正常使用 Antigravity
  • 希望 Open Design 通过 API 方式调用 Antigravity
  • 不想单独配置其他云端模型服务
  • 需要在 Open Design 的「自己的模型 Key / BYOK」里填写一个本机 Base URL

不适合这种方式的情况:

  • Antigravity 本身还没有登录或不能正常对话
  • Antigravity Tools 的反代服务没有启动
  • 只是想用本机 CLI,这种情况优先看 欢迎页操作说明 里的「本地 Coding Agent」

准备工作

开始前先准备三件事:

  1. 安装并登录 Antigravity,确认它本身可以正常使用
  2. Antigravity Manager 发布页 下载与系统匹配的 Antigravity Tools
  3. 打开 Antigravity Tools,并在软件里启动反代服务

发布页会列出不同系统的安装包,例如 macOS 的 .dmg、Linux 的 .AppImage / .deb / .rpm 等。下载时按自己的系统和芯片架构选择,不确定时优先选择软件页面推荐的版本。

在 Antigravity Tools 里启动 API

Antigravity Tools 的界面可能会随版本变化,但通常按这个思路操作:

  1. 打开 Antigravity Tools
  2. 添加 Antigravity 账号
  3. 确认账号状态正常
  4. 找到和 APIProxy反代代理服务 相关的区域
  5. 启动反代服务
  6. 记下软件显示的 API 地址、端口、协议和模型名称

需要重点记下这些信息:

信息在 Open Design 里填到哪里
API 协议填到「API 协议」,常见是 OpenAIAnthropic
API 地址填到 Base URL
API Key填到 API Key
模型名称填到「模型」
GLOSSARY / 术语说明

本机 API 地址

本机 API 地址通常长得像 http://127.0.0.1:端口号http://localhost:端口号。它表示服务只在你的电脑上运行。

如果 Antigravity Tools 显示的完整地址带有 /v1,例如 http://127.0.0.1:8045/v1,就把完整地址填到 Open Design 的 Base URL。不要自己额外拼接路径,也不要删掉软件明确显示的路径。

如果页面只显示端口或基础地址,以软件界面里的说明为准。Base URL 填错时,Open Design 通常会提示地址不可达或测试失败。

在 Open Design 里填写

拿到 Antigravity Tools 显示的信息后,回到 Open Design:

  1. 打开「设置」,点击「执行模式」
  2. 选择 BYOKAPI 提供方
  3. API 协议按 Antigravity Tools 显示的协议选择
  4. 快速填充提供方选择 自定义提供方
  5. API Key 填 Antigravity Tools 显示的 Key
  6. Base URL 填 Antigravity Tools 显示的 API 地址
  7. 模型填 Antigravity Tools 显示或支持的模型名称
  8. 点击 测试
  9. 测试通过后,关闭设置,回到主页或项目页继续使用

如果 Antigravity Tools 明确说明本机服务不校验 API Key,但 Open Design 里 API Key 是必填项,可以填一个仅用于占位的字符串,例如:

local-antigravity

如果软件界面显示了专门的 Key,请优先使用软件显示的 Key。

常见填写示例

以下只是示例,实际填写以 Antigravity Tools 界面为准。

配置项示例
API 协议OpenAI
快速填充提供方自定义提供方
API Keylocal-antigravity,或软件显示的 Key
Base URLhttp://127.0.0.1:8045/v1
模型软件显示的模型名称

测试失败时检查什么

如果 Open Design 提示 Base URL 无效、不可达,或「测试」失败,按下面顺序检查:

  1. Antigravity 是否已登录且本身可以正常使用
  2. Antigravity Tools 是否仍在运行
  3. 反代服务是否已点击启动
  4. Base URL 是否和软件显示的一致,包括端口号和 /v1 等路径
  5. Open Design 里的 API 协议是否和 Antigravity Tools 显示的一致
  6. API Key 是否填到了设置框,而不是任务输入框
  7. 模型名称是否是当前反代服务支持的名称

如果修改过 Antigravity Tools 的端口或协议,请回到 Open Design 重新填写 Base URL,并再次点击 测试

使用时要注意

  • Antigravity Tools 关闭后,本机 API 通常也会不可用
  • 电脑重启后可能需要重新打开 Antigravity Tools 并启动反代服务
  • 不要把 API Key 写进任务输入框、截图或公开文档
  • 如果要上传截图让 Open Design 理解图片,请确认当前模型支持图片理解
  • 如果生成过程长时间没有响应,先检查 Antigravity 本身和反代服务是否仍然可用

Comments

评论与提问

欢迎补充问题或反馈。提交评论时需要登录,评论会先进入审核。

0 条

还没有公开评论。你可以提交第一个问题。

提交时会提示登录。 请勿填写手机号、API Key、密码等敏感信息。