RealRelay.ai
编码智能体

AionUi 接入指南

通过 AionUi 的 New API 平台把它的内置智能体接入 RealRelay.ai：从控制台一键开始或手动添加平台，然后检查连接并选择模型。

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

概览

AionUi 是一款免费、开源的桌面应用，让 AI 智能体在你的电脑上工作：经你批准后，它们可以读写文件、执行任务、使用工具。它自带一个内置智能体，你要接入 RealRelay.ai 的就是这个智能体。AionUi 的 New API 平台默认把每个模型的请求发往 /v1/chat/completions；对于你设为 Anthropic 协议的模型，则发往 /v1/messages。

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

  • 带 /v1 的基础地址。New API 平台也接受站点根地址，并会自行补全路径。

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

AionUi 还能驱动它在你电脑上找到的 Claude Code、Codex 等 CLI 智能体。这些智能体保留各自的设置，不使用你在这里添加的模型；请按它们各自的指南配置，或使用 CC Switch。本配置尚未在 RealRelay.ai 上端到端跑通。

一键配置

控制台提供一个 aionui:// 链接，可以打开 AionUi 的模型设置。请先安装 AionUi（见下方“安装”），浏览器才知道如何打开它。

  1. 1

    打开密钥的菜单

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

  2. 2

    填写 Add Model 对话框

    AionUi 会打开 Settings → Models 并弹出 Add Model 对话框。在 AionUi 2.2 中，由于两边使用的字段名不同，控制台的链接不会自动填入地址和密钥。请按“配置”一节所示填写对话框，然后点击 Confirm。

这个链接只是帮你省去了导航步骤，所以如果你的控制台中没有 Chat → AionUI 选项，按下面的手动步骤操作也一样快。

安装

在 macOS 上可以用 Homebrew 安装 AionUi，也可以从 GitHub Releases 下载适合你系统的安装程序。它需要 macOS 10.14、Windows 10，或 Ubuntu 18.04 及以上等较新的 Linux 发行版，内存至少 4 GB。

macOS (Homebrew)
brew install aionui

或者下载适用于 Apple Silicon 或 Intel 的 .dmg，打开后把 AionUi 拖进“应用程序”。

下载 .exe 安装程序，按提示操作。

用包管理器安装 .deb，或者给 .AppImage 加上可执行权限后运行。

配置

  1. 1

    打开模型设置

    点击左侧边栏中的设置图标，打开 Models，然后点击 Add Model。

  2. 2

    选择 New API 并填写字段

    把 Model Platform 设为 New API，然后填入端点、你的密钥和第一个模型。保持 Full URL 关闭，让 AionUi 自动补上请求路径。把 sk-*** 替换成你的密钥。

    Settings → Models → Add Model
    1Model Platform: New API2API Endpoint:   https://www.realrelay.ai/v13Full URL:       off4API Key:        sk-***5Model Name:     z-ai/glm-5.2
  3. 3

    设置模型的调用方式

    AionUi 会为每个模型保存一个 Request Protocol。除 Claude 模型外一律使用 OpenAI，并把 OpenAI request API 设为 Chat Completions；RealRelay.ai 只在 Responses API 上提供少数几个 OpenAI 模型。

    Settings → Models → model settings
    Model:              z-ai/glm-5.2Request Protocol:   OpenAIOpenAI request API: Chat Completions
  4. 4

    保存

    点击 Confirm。RealRelay.ai 现在会连同你添加的模型一起出现在模型列表中。

  • New API 是 AionUi 为 RealRelay.ai 这类 New API 网关提供的平台。它允许每个模型使用各自的协议，并且基础地址带不带 /v1 都可以。

  • 如果你只使用 Chat Completions 模型，Custom (OpenAI Compatible) 平台同样可用。使用该平台时，端点必须以 /v1 结尾。

    Settings → Models → Add Model
    1Model Platform: Custom (OpenAI Compatible)2API Endpoint:   https://www.realrelay.ai/v13API Key:        sk-***4Model Name:     z-ai/glm-5.2

  • API Key 字段可以填多个密钥，用逗号或换行分隔。AionUi 会轮换使用，并在某个密钥失败时短暂跳过它。

验证

  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

    运行健康检查

    在 Settings → Models 中对该模型运行 Health Check。显示出延迟数值，就说明 AionUi 已连通 RealRelay.ai。

  3. 3

    发送一条消息

    用内置智能体新建一个对话，在输入框左下角的模型选择器中选中 RealRelay.ai 的模型，发一条简短消息。之后该请求会出现在控制台的用量日志中。

模型

在 Settings → Models 中 RealRelay.ai 平台的条目里继续添加模型。你可以从 AionUi 从 RealRelay.ai 加载的列表中选择，也可以输入任意模型 ID。在对话中，用输入框左下角的选择器切换模型。

  • 内置智能体会调用工具，所以请选择支持工具调用的模型。AionUi 可能会在对话的模型选择器中隐藏不支持工具调用的模型。

  • Claude 模型可以使用 RealRelay.ai 原生提供的 Anthropic 协议。对于以 anthropic 开头的 ID，AionUi 会自动选择该协议：

    Settings → Models → model settings
    Model:            anthropic/claude-sonnet-4-6Request Protocol: Anthropic

  • 不要把模型设为 Gemini 协议。RealRelay.ai 没有 Gemini 文本模型。

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

故障排查

  • 通过控制台链接打开后，Add Model 对话框是空的。这是 AionUi 2.2 中的预期行为；请按上文手动填写各字段。

  • 模型列表为空或加载失败。密钥有误或已被禁用，或者端点有拼写错误。在API 密钥页面检查密钥，并核对地址，然后重试。

  • 404。开启了 Full URL，或者使用 Custom 平台时端点缺少 /v1。关闭 Full URL，并使用上文所示的端点。

  • OpenAI 模型报出与模型或端点相关的错误。AionUi 把请求发到了 Responses API。请把 OpenAI request API 设为 Chat Completions，除非该模型是 RealRelay.ai 在 Responses 上提供的那几个之一。

  • 已配置的模型没有出现在对话中。该模型不支持工具调用，或者设置还没有重新加载。选择支持工具调用的模型，再保存一次并重启 AionUi。

  • AionUi 中的 Claude Code 或 Codex 没有使用 RealRelay.ai。这些智能体使用各自的配置。请单独为它们配置，例如使用 CC Switch。