木智利
13 篇在线开始阅读
Gemini · 图文教程

把 Antigravity 可用模型，接入 Cherry Studio

从登录授权到启动本地 API，再填写接口、选择模型并完成对话测试。

作者：小佛爷 · 智能体先锋队成员8 步按图操作一页看完
FIG 07 · PROXY.FLOWLIVE
Gemini 反代接入8 步

把可用模型接到自己的客户端

想在 Cherry Studio 中使用 Antigravity 账号的可用模型，可以用 Antigravity Manager 建立本地 API，方便对话和查看配额。下面按图完成同机接入。

Windows 图解 · 截图界面与模型以实际版本为准 · 内容核对于

01

STEP 01 / 08

从项目发布页下载 Antigravity Manager

以 Windows 为例，先安装反代工具与 Cherry Studio。已有可正常使用的软件可直接继续。

  1. 确认原项目地址

    打开下方 Draculabo/AntigravityManager 项目，进入 Releases。不要只按软件名称搜索下载站，也不必照着旧截图的 Star 数量或版本号找。

  2. 选系统和处理器架构

    Windows 选择对应 x64 或 ARM64 的 .exe 安装包，也可按发布说明选 MSI；macOS、Linux 选择对应平台包。不要下载 Source code 当作安装包。图中 0.20.0 为历史示例。

  3. 安装并打开

    按安装向导完成安装，可按需选择磁盘。为减少路径兼容问题，可像原帖一样使用简短的英文目录。打开后确认能进入仪表盘。

  4. 准备 Cherry Studio

    还没有客户端时，从 Cherry Studio 官方项目下载对应系统安装包。本篇后半部分以它演示，先把两款软件都准备好。

打开原项目下载 Manager 安装包下载 Cherry Studio
图1：选择 Windows 对应架构的安装包
图1：选择 Windows 对应架构的安装包

图中版本为原帖记录的 0.20.0；实际下载以发布页为准。

  1. 原帖显示 x64 与 ARM64 安装包，选择与自己电脑一致的架构。

也可以让本机 Codex 协助安装

请从 https://github.com/Draculabo/AntigravityManager/releases/latest 下载并安装适合本机系统与架构的 Antigravity Manager。先核对发布来源与安装目录，保留已有账号配置；若发布页提供 SHA256，则核对校验值。安装后确认程序能启动，然后停止，把账号登录、OAuth 授权和启动服务交给我自己操作。
完成标志
  • 我已打开 Manager 主界面，并准备好 Cherry Studio。
02

STEP 02 / 08

添加自己的 Google 账号，完成 OAuth 授权

在自己的浏览器完成登录与确认。授权成功后，还要返回工具核对账号状态。

  1. 先确认账号可正常访问

    用自己的浏览器登录 Google，并确认账号可以使用 Antigravity 相关服务。如果官方页面要求首次设置或验证，先在官方页面完成。

  2. 点击添加账号

    打开仪表盘，点击「添加账号」。在弹窗保持「OAuth 授权」选中，再点击「开始 OAuth 授权」。

  3. 在浏览器选择正确账号

    完成 Google 登录并核对授权页面。若浏览器沿用另一个账号，先切换到本次要添加的账号，确认授权后等待回调。

  4. 看到成功提示后返回工具

    网页出现 Authorization Successful 后，回到 Manager，确认账号已加入。若窗口未自动打开，复制工具本次生成的授权链接，在自己的浏览器中打开；需要手动回调时，按当前窗口提示粘贴。

图2：打开工具，点击「添加账号」
图2：打开工具，点击「添加账号」

账号姓名和邮箱已遮挡。

  1. 点击仪表盘右上方的「添加账号」。
图3：选择 OAuth 授权并打开浏览器
图3：选择 OAuth 授权并打开浏览器

授权链接已遮挡，实际操作使用自己窗口生成的链接。

  1. 保持 OAuth 授权选中。
  2. 优先点击「开始 OAuth 授权」。
  3. 浏览器未打开时，复制自己窗口的新授权链接。
图4：看到 Authorization Successful 后回到工具
图4：看到 Authorization Successful 后回到工具

这是原帖的授权完成提示。

  1. 网页显示授权成功后，回到工具检查账号是否出现。
完成标志
  • 网页显示授权成功，账号已出现在 Manager 中。
03

STEP 03 / 08

确认模型配额正常，再启用账号

账号能登录，不代表目标模型一定可用。先处理验证或权限异常，再继续启动服务。

  1. 进入账号管理并刷新

    打开「账号管理」，刷新刚添加账号的配额。核对邮箱是否正确，以及你准备调用的模型是否有可用额度。

  2. 先处理异常账号

    如果显示 403、账号需验证、账号已禁用或配额为零，先看详细原因。不要把有异常的账号直接加入使用池；处理方法见最后一步。

  3. 选中正常账号并启用

    按原帖勾选准备使用的账号，点击「启用」。多个账号时，逐个确认状态；只启用自己已授权且可使用的账号。

  4. 确认模型名称与实际可用性

    界面里的套餐标识、百分比和模型列表是当前账号的结果。截图显示的 100% 不代表你的账号相同，也不意味着所有模型都可调用。

图5：检查模型配额，选中可用账号并启用
图5：检查模型配额，选中可用账号并启用

模型与百分比是当时截图状态，以自己的账号实际结果为准。

  1. 勾选准备使用的账号。
  2. 确认模型配额正常，没有 403 等异常。
  3. 点击绿色「启用」，只启用自己确认可用的账号。
完成标志
  • 准备使用的账号状态正常，已启用且有目标模型配额。
04

STEP 04 / 08

打开 API 反代，确认「服务运行中」

先让本机代理服务启动，再给客户端填写连接信息。

  1. 进入 API 反代页面

    点击顶部「API 反代」，找到服务配置区域。首次启动可能有项目风险说明，读完后再决定是否启动。关闭确认窗口不会启动服务。

  2. 点击启用或启动服务

    按钮名称可能随版本变化。启动后应看到绿色「服务运行中」和可用账号数；图中已在运行，因此右侧按钮显示「停止服务」。

  3. 核对端口与访问范围

    原帖端口是 8045，实际以自己的窗口为准。同一台电脑使用时，保留仅本机访问并开启访问授权，不需要为了跟教程操作而开放局域网或公网。修改端口后按提示重启服务。

  4. 保持程序与服务运行

    客户端请求要经过 Manager。退出工具或停止服务后，本地地址就不能提供模型响应；需要时可按自己的习惯设置随应用启动。

图6：进入「API 反代」，确认服务正在运行
图6：进入「API 反代」，确认服务正在运行

截图已在运行，右上角因此显示「停止服务」；未启动时按钮不同。

  1. 打开「API 反代」页面，点击启用或启动服务。
  2. 看到绿色「服务运行中」后再配置客户端。
  3. 记下实际端口；原帖示例为 8045。
查看项目使用与账号提示
完成标志
  • 服务已运行，我已记下实际监听端口。
05

STEP 05 / 08

准备 Base URL、API Key 和模型 ID

三项信息都从自己的 Manager 获取。下面的地址和模型只是原帖示例。

  1. Base URL：找到 OpenAI 协议卡片

    在 API 反代页向下找到「多协议支持」，选择本篇使用的 OpenAI 协议卡片，点击「复制 BASE」。同机示例为 http://127.0.0.1:8045/v1；如果你修改过端口，就会不同。

  2. API Key：复制本地服务的密钥

    在服务配置区域找到「API 密钥」，点击右侧复制按钮。这里要填写的是 Manager 的网关密钥，不是 Google 密码，也不是另买的 OpenAI API Key。

  3. 模型 ID：从支持模型列表获取

    在「支持模型与集成」中复制需要的模型 ID。原帖使用 gemini-3.1-pro；请优先选择自己的账号当前可用、服务端实际列出的模型。显示名称和模型 ID 不要混淆。

  4. 确认客户端和服务在同一台电脑

    127.0.0.1 指向当前运行客户端的设备。手机、另一台电脑、远程服务器或容器不会自动访问到你的桌面服务；本篇先完成同机连接，再单独规划其他部署。

原帖示例：请按自己的 Manager 实际值填写
客户端字段来源与填写方式
API 地址http://127.0.0.1:8045/v1
使用当前服务的 BASE 与端口
API 密钥从本机服务复制，不提供公共密钥
模型 IDgemini-3.1-pro
使用服务端当前支持的模型 ID
图7：复制 OpenAI 协议的 Base URL 与模型 ID
图7：复制 OpenAI 协议的 Base URL 与模型 ID

右侧示例代码中的密钥已遮挡。图中 gemini-3.1-pro 只作原帖示例。

  1. 在 OpenAI 协议卡片复制 BASE。
  2. 在支持模型列表复制实际可用的模型 ID。
图8：复制 API 密钥
图8：复制 API 密钥

密钥已用不透明色块遮挡。不要从截图或公开网页获取密钥。

  1. 点击 API 密钥右侧复制按钮，把密钥填入自己的客户端。
完成标志
  • 我已在本机找到这三项信息，确认来自同一个正在运行的服务。
06

STEP 06 / 08

添加服务商，填入接口与模型

本篇使用 OpenAI 兼容协议连接本地网关，按设置、模型服务、添加的顺序操作。

  1. 找到添加服务商入口

    打开 Cherry Studio，依次点击左下角「设置」、左侧「模型服务」、服务商列表底部「添加」。

  2. 选择兼容协议与名称

    提供商名称可以写「反重力反代」，提供商类型选「OpenAI」，点击确定。这里选的是接口协议，实际调用哪个模型由下一项模型 ID 决定。

  3. 填写自己的密钥和 API 地址

    进入新服务商详情，填入刚复制的 API Key 与 Base URL。原帖示例是 http://127.0.0.1:8045/v1。看下方请求预览，确认只出现一次 /v1，末尾为 /chat/completions。不要把完整请求路径再当作 BASE 填进去。

  4. 添加模型并开启服务商

    点击「获取模型列表」，添加实际支持的模型；取不到列表时，可通过加号手动填写服务端给出的模型 ID。原帖为 gemini-3.1-pro。最后确认右上角开关为开启。

图9：Cherry Studio：设置、模型服务、添加
图9：Cherry Studio：设置、模型服务、添加

本图只定位设置入口，原有服务商无需照抄。

  1. 点击左下角设置。
  2. 打开「模型服务」。
  3. 点击服务商列表底部的「添加」。
图10：添加 OpenAI 类型的自定义服务商
图10：添加 OpenAI 类型的自定义服务商

选择 OpenAI 类型不代表模型变成 GPT，实际模型由服务端和模型 ID 决定。

  1. 名称可以填写「反重力反代」。
  2. 提供商类型选择 OpenAI，表示兼容协议。
  3. 点击「确定」，再到详情页填写连接信息。
图11：填写密钥、API 地址并添加模型
图11：填写密钥、API 地址并添加模型

示例地址 http://127.0.0.1:8045/v1 只适用于同机与该端口，不能当作远程服务器地址。

  1. 填写 Manager 中复制的 API Key。
  2. 填写 Base URL，核对下方完整请求预览。
  3. 获取模型列表或手动添加服务端支持的模型 ID。
  4. 打开右上角的服务商开关。
Cherry Studio 服务商配置说明API 地址与路径补全说明
完成标志
  • 服务商已启用，密钥、API 地址和实际模型 ID 均已填写。
07

STEP 07 / 08

先检测连接，再发送一次真实请求

既要看到连接成功，也要确认对话能返回，并在 Manager 中看到对应请求。

  1. 点击 API 密钥右侧的检测

    等待测试结束，成功时会显示「连接成功」或对勾。检测失败时，先核对 Manager 是否运行、地址端口是否一致、密钥和模型 ID 是否正确。

  2. 新建一个对话并选对模型

    回到聊天页，新建对话。在顶部模型选择中找到「反重力反代」下的目标模型，避免继续使用之前的其他服务商。

  3. 发一个小问题测试

    例如「请用一句话解释什么是 API」。收到完整回复后，再发送后续问题。模型自报身份只能作为文本内容，不能单独证明后台使用了哪个模型。

  4. 到 Manager 核对本次请求

    在流量日志或请求监控中查看时间、模型和结果是否对应这次对话。连接检测、实际回复与服务端请求记录相互对应，才算完成这条连接流程。

图12：点击检测，确认出现「连接成功」
图12：点击检测，确认出现「连接成功」

连接检测只验证本次请求，持续可用性取决于模型、配额和上游服务。

  1. 点击密钥右侧检测按钮，等待请求结束。
  2. 出现连接成功与对勾后，再进行实际对话。
图13：新建对话，选择这家服务商下的模型
图13：新建对话，选择这家服务商下的模型

这是小佛爷当时的对话示例；模型自报身份不能单独证明后台路由，需同时核对服务端请求记录。

  1. 在对话顶部选择「反重力反代」对应模型。
  2. 发送一个简短问题，确认收到实际回复。

复制一个简短测试问题

请用一句话解释什么是 API。

完成标志
  • 连接检测通过，实际对话成功，服务端能看到对应请求。
08

STEP 08 / 08

按错误提示排查，保留可复现的信息

先区分服务未启动、地址或密钥不匹配、账号验证与上游限制，再采取对应操作。

  1. 添加账号失败或超时

    fetch failed、超时等提示先检查网络连接、软件代理和浏览器授权回调。必要时尝试自己的 TUN 设置，确认官方登录能打开，再重新发起一次授权；不要连续复用已失效的授权码。

  2. 403 且明确提示账号需验证

    在 Google 官方登录页或官方应用完成它要求的验证。原帖用手机 Google App 登录对应账号，再按提示操作；具体方式以官方当次要求为准。完成后回工具重新授权或刷新配额。

  3. 账号已禁用或受限

    先点「查看原因」，区分自己手动禁用、凭据失效与上游限制。官方服务仍不可用时，按其恢复或申诉入口处理。原帖提到等待后再试是个人经验，不能保证恢复，不作为固定解决步骤。

  4. 连接被拒绝、401、404 或模型不可用

    连接被拒绝先查服务是否运行与端口；401 核对网关密钥和访问授权；404 检查路径是否重复 /v1；模型错误核对模型 ID 与实际权限。429 先按提示等待并减少并发，502 则结合服务端日志检查上游与网络。

图14：添加账号失败：先看错误详情
图14：添加账号失败：先看错误详情

授权码已遮挡。网络失败不等同于账号失效。

  1. 记录 fetch failed、超时或其他原始错误，再按对应原因排查。
图15：403 且提示「账号需验证」
图15：403 且提示「账号需验证」

邮箱已遮挡；不要扫码他人的验证页面或上传验证码。

  1. 仅当实际提示账号需验证时，按 Google 官方页面的要求完成验证。
图16：账号被禁用：查看原因后再处理
图16：账号被禁用：查看原因后再处理

不把「养号两三天」写成必定恢复的解决方案。

  1. 点「查看原因」，分清手动禁用、授权失效与上游限制。
原项目问题反馈
完成标志
  • 我已了解服务保持运行、验证账号及错误排查的方法。

常见问题

遇到问题，先看这里

这是把 Gemini 网页会员变成官方 API 额度吗？

本教程连接的是工具提供的本地网关，使用已授权且有权限的上游账号。网页会员、Antigravity 可用模型与官方 Gemini API 是不同服务，不保证某种会员一定获得可用模型，也不是无限额度。

软件界面和图不一样怎么办？

截图来自原帖。优先按添加账号、账号管理、API 反代、模型服务等名称定位；端口、模型列表与安装包以当前版本实际显示为准。

必须一直开着工具吗？

本篇在自己的电脑运行本地服务。Manager 或代理服务停止后，Cherry Studio 就不能从这个地址获取响应。

为什么选择 OpenAI 类型却用 Gemini？

OpenAI 类型在这里表示兼容接口协议。服务端按模型 ID 路由，名称不会把 Gemini 变成 GPT。

Base URL 应不应该带 /v1？

使用 Manager 的 BASE 并检查客户端最终预览。本篇原帖为 http://127.0.0.1:8045/v1，完整请求预览应只有一个 /v1/chat/completions；按当前客户端的路径补全规则调整。

手机能直接填 127.0.0.1 吗？

不能连接到桌面电脑。127.0.0.1 是手机自己。本篇只演示同机，不要求打开局域网或把服务暴露到公网。

有百分比，为什么某个模型仍不可用？

模型显示、账号资格、额度窗口与接口兼容都可能影响实际请求。用当前账号支持的 ID 做小请求，并查看日志中的具体原因。

403 一定是 IP 不干净吗？

不是。只有错误明确要求账号验证时，才走对应验证流程。其他 403 还需结合权限、地区和错误详情排查。

显示账号被禁用，等两三天就能好吗？

不能保证。先区分手动禁用、登录失效与上游限制，按官方提示恢复。不要把等待或更换网络当作一定能解除限制的方法。

连接检测成功，算全部配置好了吗？

还要选中新服务商下的模型，发送实际问题，并在 Manager 的请求日志核对。本教程不代替其他 Agent 各自的协议与功能兼容测试。