Cherry Studio

設定 Cherry Studio 本機供應商的 OpenAI 基底位址與模型清單。

安裝與準備

從 Cherry Studio 發布頁面下載 Windows、macOS 或 Linux 安裝包並啟動桌面應用。在 routerra.ai/keys為客戶端建立金鑰，並從網關模型清單複製獲准模型 ID。無需 Docker 或本機推理伺服器；金鑰保存在客戶端供應商設定中。

設定連線

開啟 Settings → Model Services → + Add Provider，命名為 routerra.ai，端點選擇 OpenAI，基底位址填 https://routerra.ai/v1，API Key 填 YOUR_API_KEY。若版本顯示 API Address，填 https://routerra.ai/v1，並查看請求 URL 預覽，確認最終為 /v1/chat/completions。新版按協定分別設定端點，請設定 OpenAI 聊天端點，而非 Anthropic 或 Responses。儲存並啟用供應商。

OpenAI base URL: https://routerra.ai/v1
API Key: YOUR_API_KEY
Model ID: YOUR_MODEL_ID
Generated chat URL: https://routerra.ai/v1/chat/completions

選擇模型與排除錯誤

點選 Get model list 加入獲准模型，或用 + 手動新增 YOUR_MODEL_ID。建立聊天並選擇該供應商與模型，傳送簡短文字。404 時檢查最終 URL 是否重複 /v1 或缺少 /chat/completions；清單為空時確認供應商已啟用，並手動新增精確 ID。金鑰檢查成功不代表能呼叫所有模型。