開發者資源
Cherry Studio
將 Cherry Studio 連接至 RunAPI 並驗證對話。
使用自訂 OpenAI 供應商將 Cherry Studio 連接至 RunAPI。在繼續之前，請在身份驗證 指南中建立標準的 RunAPI API 金鑰。
安裝 Cherry Studio
按照官方 Cherry Studio 下載指南安裝桌面應用程式，然後開啟其設定。
新增 RunAPI 提供商
- 開啟Settings -> Model Services -> + Add。
- 將提供商名稱設定為
RunAPI，Provider type設定為OpenAI。 - 輸入您的 RunAPI API 金鑰，並將 API 位址設定為
https://runapi.ai/v1。 - 從模型目錄新增確切的模型識別碼，啟用提供商並儲存。
由於供應商類型為 OpenAI，此欄位使用 RunAPI 的
OpenAI 相容 Base URL，其中包含 /v1。Cherry Studio 會為
Chat Completions 請求附加
/chat/completions，因此請勿將完整的操作 URL 貼入 API 地址欄位。
選擇模型
自訂提供者依賴您新增的模型。若選擇器為空， 請返回提供者的模型管理區域，手動新增精確的 RunAPI 識別符。新增模型並不授予該模型不支援的功能。
執行連線檢查
使用已儲存的模型執行連線檢查。此操作會傳送模型請求，而非僅驗證金鑰格式。檢查成功即確認供應商 URL、金鑰及所選模型可協同運作。
驗證連線
開始新的聊天，選擇 RunAPI 供應商及模型，然後傳送 Reply
with the word connected. 正常的完整或串流回覆確認當前聊天正在使用 RunAPI。
疑難排解
- 模型選擇器為空： 請在自訂 provider 的模型管理區域新增確切的模型識別碼，並確認 provider 已啟用。
- 連線檢查失敗： 請確認已選擇模型，以有效的標準金鑰替換現有金鑰，然後重試。
- 請求返回
404： 請使用https://runapi.ai/v1作為 API 地址；請勿自行附加/chat/completions。 - Text 正常但 vision 或 tools 失敗： 請在模型目錄中選擇一個宣告了所需功能的模型。
有關共享協議行為，請使用 LLM API 快速入門。有關請求及回應欄位，請使用 Chat Completions API 參考。