RealRelay.ai
程式碼代理

AionUi 設定指南

透過 New API 平台將 AionUi 的內建代理接上 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 平台也接受網站根位址,並會自行修正路徑。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 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,或較新的 Linux(例如 Ubuntu 18.04 或更新版本),且至少 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 只有少數 OpenAI 模型在 Responses API 上提供。

    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

    直接呼叫端點

    用你的金鑰執行這段指令。若收到含 choices 陣列的 JSON 回覆,就代表位址、金鑰與模型都沒問題。

    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 模型可使用 Anthropic 協定,RealRelay.ai 原生提供此協定。對於以 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。除非該模型是 RealRelay.ai 在 Responses 上提供的模型,否則請把 OpenAI request API 設為 Chat Completions。

  • 已設定的模型沒有出現在對話中。該模型不支援工具呼叫,或設定尚未重新載入。請選擇支援工具呼叫的模型,再儲存一次並重新啟動 AionUi。

  • AionUi 中的 Claude Code 或 Codex 沒有使用 RealRelay.ai。這些代理使用各自的設定。請另外設定它們,例如使用 CC Switch。