跳到主要內容
開發者資源
開發者資源

Chatbox AI

安裝 Chatbox AI,新增 RunAPI 自訂提供者,擷取模型,執行連線檢查,並驗證聊天。

使用自訂 BYOK 供應商將 Chatbox AI 連接至 RunAPI。以下名稱遵循當前的自訂供應商介面;標籤在不同桌面版本間可能略有差異。在繼續操作前,請先至身分驗證指南建立標準 RunAPI API 金鑰。

安裝 Chatbox AI

從其官方下載頁面或 官方發布頁面下載 Chatbox AI,然後開啟設定。

新增 RunAPI 提供者

  1. 開啟 AI Provider / Model Settings 並選取 Add Provider。
  2. 將其命名為 RunAPI,並選擇 OpenAI API Compatible 作為 API 模式。
  3. 輸入您的 RunAPI API 金鑰。
  4. 將 API Host 設為 https://runapi.ai/v1,並將 API Path 設為 /chat/completions。
  5. 確認 URL 預覽結尾為 https://runapi.ai/v1/chat/completions,然後儲存。

請將 Host 與 Path 分開設定。Fetch 使用 Host 加上 /models 來建立模型探索,而聊天則使用 Host 加上已設定的 API Path。

新增並檢查模型

選取 Fetch 以載入 RunAPI 模型清單。若自動探索無法使用,請選取 New 並從模型目錄輸入確切的識別碼。Chatbox AI 在執行 Check 之前,至少需要一個已儲存的模型。

選取 Check,選擇已儲存的模型,然後執行連線測試。以成功的 Text Request 作為基準訊號。Vision Request 和 Tool Use Request 取決於所選模型的功能,可能會各自失敗,但不影響基本文字對話的有效性。

驗證連線

開啟新的對話,在模型選擇器中選擇已儲存的 RunAPI 模型,並傳送 Reply with the word connected.。收到正常回應即確認自訂提供者已啟用。

疑難排解

  • URL 預覽不正確: 請將 Host 設為 https://runapi.ai/v1,Path 設為 /chat/completions;請勿將完整的操作 URL 同時填入兩個欄位。
  • Check 已停用或沒有模型: 請先使用 Fetch 或 New 新增至少一個模型。
  • Text Request 因身分驗證錯誤而失敗: 請以身分驗證指南取得的有效標準金鑰更新 provider。
  • Text 可正常運作,但 Vision 或 Tool Use 失敗: 請從模型目錄選擇一個聲明具備所需功能的模型;這些 check 並非所有 provider 的通用需求。

如需共用協定行為,請參閱 LLM API 快速入門。如需請求與回應欄位,請參閱 Chat Completions API 參考。