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

Jan

將 RunAPI 新增為 Jan 的提供者並驗證聊天功能。

檢視 Markdown

使用自訂 OpenAI 相容供應商將 Jan 連接至 RunAPI。在繼續操作前，請先至身分驗證指南建立標準 RunAPI API 金鑰。

安裝 Jan

從 Jan 官方網站下載並安裝桌面應用程式，然後開啟其設定。

新增 RunAPI 提供者

  1. 開啟 Settings -> Model Providers -> Add Provider。
  2. 將 API 格式設為 OpenAI-compatible，並將提供者名稱設為 RunAPI。
  3. 將 Base URL 設為 https://runapi.ai/v1，輸入您的 RunAPI API 金鑰，然後建立提供者。
  4. 選取自動探索到的模型，或在提供者的 Models 區域中，從模型目錄新增確切的識別碼。

所選 API 格式與 OpenAI 相容，因此此 Base URL 包含 /v1。使用其他公開協定的提供者必須改用該協定專屬的用戶端設定。

儲存提供者後，Jan 會請求 {base_url}/models，解析為 https://runapi.ai/v1/models。若所需的模型未出現在清單中，請改用手動 + 操作，而非變更 Base URL。

設定模型功能

Jan 不會自動推斷自訂提供者的所有功能。請僅啟用所選模型在模型目錄中聲明支援的視覺、工具或音訊行為。UI 開關無法新增 API 不支援的功能。

驗證連線

開啟新的對話，選取 RunAPI 模型，並傳送 Reply with the word connected.。收到正常的完整或串流回應即確認提供者和模型已啟用。

疑難排解

  • 所有請求均回傳 404： 請確認 Base URL 包含 /v1；Jan 會自動附加操作路徑。
  • 沒有顯示任何模型： 請確認 Base URL 為 https://runapi.ai/v1，然後手動新增正確的模型識別碼。
  • 建立 Provider 時回傳 401 或 403： 請以有效的標準 RunAPI API 金鑰取代現有金鑰，而非使用 Management Key。
  • 功能控制與模型不符： 請根據各自訂模型所聲明的功能進行設定，而非依賴自動偵測。
  • 備援金鑰未被嘗試使用： Jan 僅針對 401、403 或 429 錯誤輪換金鑰；其他錯誤不會觸發金鑰輪換。

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