開發者資源
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 相容基礎 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 或工具失敗： 請從模型目錄選擇一個聲明具備所需功能的模型。
如需共用協定行為，請參閱 LLM API 快速入門。如需請求與回應欄位，請參閱 Chat Completions API 參考。