RealRelay.ai
编码智能体

Cherry Studio 接入指南

把 RealRelay.ai 作为 OpenAI 类型的提供商接入 Cherry Studio：从控制台导入密钥，或以站点根地址作为 API 地址手动添加，然后检查连接并添加模型。

创建 API 密钥浏览目录
协议
OpenAI Chat Completions
基础地址
https://www.realrelay.ai
官方文档
docs.cherry-ai.com
已对照工具官方文档核对
2026-10
实验性. 尚未在 RealRelay.ai 上端到端跑通。步骤依据该工具的官方文档；如果某一步失败，请带上错误信息联系支持。

概览

Cherry Studio 是一款桌面聊天客户端，可以同时对接多家模型提供商，并在此之上提供助手、知识库和工具。它以 OpenAI 兼容提供商的方式接入 RealRelay.ai，使用 /v1/chat/completions 端点。

  • 一个从控制台的 API 密钥页面获取的 API 密钥。

  • API 地址是站点地址，不带 /v1。与大多数 OpenAI 兼容客户端不同，Cherry Studio 会自己拼上 /v1/chat/completions。

  • 一个与 GET /v1/models 列出的完全一致的模型 ID，例如 z-ai/glm-5.2。

Cherry Studio 自己的文档中，部分按钮仍沿用 1.x 的名称，而 2.x 应用改了其中几个。名称不同之处，本页会同时给出两者。本配置尚未在 RealRelay.ai 上端到端跑通。

一键配置

控制台可以通过 cherrystudio:// 链接把密钥直接发送给 Cherry Studio。请先安装 Cherry Studio（见下方“安装”），浏览器才知道如何打开它。

  1. 1

    打开密钥的菜单

    在API 密钥页面，打开你要使用的密钥在 Actions 列中的 ⋯ 菜单，选择 Chat → Cherry Studio。允许浏览器打开该应用。

  2. 2

    确认密钥

    Cherry Studio 会打开提供商设置，询问是否为其内置的 New API 提供商添加该 API 密钥。对话框会显示提供商 ID 和基础地址（即站点根地址）。点击 Add。

  3. 3

    添加模型并启用提供商

    该链接只带来地址和密钥，不包括模型。请按下方“配置”和“模型”中的说明添加模型并启用提供商。

如果你的控制台中没有 Chat → Cherry Studio 选项，按下面的手动步骤操作效果完全一样。

安装

从官方下载页面或 GitHub Releases 下载 Cherry Studio。它支持 Windows、macOS 和 Linux。

按你的 Mac 芯片选择版本：M 系列 Mac 选 Apple Silicon，其他选 Intel。可以在苹果菜单的“关于本机”中查看。打开下载的文件，把 Cherry Studio 拖进“应用程序”。

运行安装程序。不支持 Windows 7。如果安装程序要求安装 Microsoft Visual C++ Redistributable，请允许它安装。

从 GitHub Releases 下载适合你架构的 Linux 安装包。

如果 Cherry Studio 能打开主窗口，说明安装成功。

配置

  1. 1

    添加提供商

    打开 Settings（齿轮图标）→ Model Provider（1.x 中为 Model Services）。点击提供商列表下方的 Add，为提供商命名，类型设为 OpenAI，然后保存。

    Settings → Model Provider → Add
    Provider Name: RealRelay.aiProvider Type: OpenAI
  2. 2

    填入密钥和地址

    打开新建的提供商。把密钥粘贴到 API Key，把站点根地址填入地址字段（2.x 中叫 API Host，1.x 中叫 API Address）。把 sk-*** 替换成你的密钥。

    Settings → Model Provider → RealRelay.ai
    API Key:  sk-***API Host: https://www.realrelay.aiModel ID: z-ai/glm-5.2
  3. 3

    启用提供商

    打开提供商页面右上角的开关。关闭的提供商会保留设置，但它的模型不会出现在模型选择器中。

  • 不要在地址后加 /v1。Cherry Studio 会自己加上 /v1/chat/completions，所以字段里写了 /v1 就会变成 /v1/v1/…。字段下方的地址预览会显示最终的 URL。

  • 以 # 结尾的地址会按原样使用，不追加任何内容。只有当你想写出完整端点时才需要这样做：

    API Host (used exactly as typed)
    https://www.realrelay.ai/v1/chat/completions#

  • API Key 字段可以填多个密钥，用英文逗号分隔。Cherry Studio 会轮流使用它们。

  • 如果你用的是控制台的一键配置，设置会保存在内置的 New API 提供商上；无需再添加第二个提供商。

验证

  1. 1

    直接调用端点

    用你的密钥运行这条命令。如果返回的 JSON 包含 choices 数组，说明地址、密钥和模型都没问题。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/chat/completions" \2  -H "Authorization: Bearer sk-***" \3  -H "content-type: application/json" \4  -d '{"model": "z-ai/glm-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    运行 Cherry Studio 的检测

    至少添加一个模型（见“模型”），然后点击 API Key 字段旁边的 Check。Cherry Studio 会用该提供商的某个模型发送一个测试请求，并报告是否成功。

  3. 3

    发送一条消息

    回到聊天页面，在模型选择器中选中 RealRelay.ai 的模型，发一条简短消息。之后该请求会出现在控制台的用量日志中。

模型

点击提供商页面底部的模型列表按钮（2.x 中为 Sync models，1.x 中为 Manage）。Cherry Studio 会从 RealRelay.ai 加载列表。在每个想用的模型旁点击 +；只有添加过的模型才会出现在聊天的模型选择器中。你也可以直接输入 ID 来添加模型。

Terminal
curl -sS "https://www.realrelay.ai/v1/models" \  -H "Authorization: Bearer sk-***"

  • 添加之前，先核对每个名称下方显示的模型 ID。RealRelay.ai 列出的 ID 带有渠道前缀，例如 z-ai/glm-5.2；来自不同渠道的相似名称是不同的模型。

  • Cherry Studio 聊天时不需要设置上下文窗口或输出上限。助手有自己的设置，用于控制发送多少条历史消息。

  • 使用工具和 MCP 服务器时，请选择支持工具调用的模型。目录中的大多数编码模型都支持。

如何挑选模型，请见选择模型。

故障排查

  • 404。地址以 /v1 或 /v1/chat/completions 结尾。只保留站点根地址。

  • 401 或提示密钥无效。密钥有误、已被禁用或额度已用完。从API 密钥页面重新复制，不要带空格。

  • 聊天的模型选择器中没有该模型。提供商处于关闭状态，或者模型只是列出来了但没有添加。启用提供商，并点击模型旁边的 +。

  • 聊天正常，但检测失败。检测会使用该提供商的某个模型。请删掉你的密钥无法调用的模型，以及不是聊天模型的模型。

  • 报“model not found”错误。模型 ID 与 RealRelay.ai 的列表不完全一致，常见原因是漏了前缀。删掉该模型，从同步的列表中重新添加。

  • 在控制台点击 Cherry Studio 后没有任何反应。Cherry Studio 没有安装，或者浏览器拦截了该链接。先启动一次 Cherry Studio 再点击，或者改用手动步骤。