RealRelay.ai
程式碼代理

Cherry Studio 設定指南

把 RealRelay.ai 設為 Cherry Studio 的 OpenAI 類型供應商:從主控台匯入金鑰,或以網站根位址作為 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。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 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。你可以在 Apple 選單的「關於這台 Mac」中查看。開啟下載的檔案,把 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

    直接呼叫端點

    用你的金鑰執行這段指令。若收到含 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

    執行 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 再點選,或改用手動步驟。