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

LibreChat

為 RunAPI 配置 LibreChat 自訂端點,在 Docker 中掛載其 YAML,重新啟動並驗證對話。

LibreChat 自訂端點屬於部署設定,而非每位用戶的連線表單。您需要存取 LibreChat 部署文件,以及從身份驗證 指南取得標準 RunAPI API 金鑰。

安裝 LibreChat

使用官方本地設定安裝 LibreChat,或使用現有部署。在新增自訂端點前,請先完成安裝。

新增 RunAPI 端點

在 LibreChat 部署目錄中建立或更新 librechat.yaml。 將 YOUR_RUNAPI_MODEL_ID 替換為模型 目錄中的現行識別符。

YAML
version: 1.3.13
endpoints:
  custom:
    - name: "RunAPI"
      apiKey: "${RUNAPI_API_KEY}"
      baseURL: "https://runapi.ai/v1"
      models:
        default: ["YOUR_RUNAPI_MODEL_ID"]
        fetch: true
      titleConvo: true
      titleModel: "current_model"
      modelDisplayLabel: "RunAPI"

將金鑰儲存在 .env 中,而非直接儲存在 YAML 檔案中:

SHELL
RUNAPI_API_KEY=YOUR_RUNAPI_API_TOKEN

對於 Docker Compose,請確保 docker-compose.override.yml 掛載 設定檔案:

YAML
services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml

更改任何此類檔案後,請重新啟動 LibreChat 部署。

選擇模型

models.default 保證至少有一個已知模型。設定 models.fetch: true 後,LibreChat 亦會請求目前的模型清單。即使啟用了探索功能,也應保留有效的預設識別符,以便在探索功能暫時不可用時端點仍可正常使用。

驗證連線

重新啟動後,從端點選擇器中選擇RunAPI,選擇已設定的模型,並傳送 Reply with the word connected.。正常回覆即確認部署設定和模型請求均正確。

疑難排解

  • RunAPI 未出現在端點選擇器中: 請驗證 YAML 縮排,確認 docker-compose.override.yml 已掛載該檔案,然後重啟 API 容器。
  • 端點已載入但身份驗證失敗: 請確認 .env 已為 API 容器定義 RUNAPI_API_KEY,如其環境已過期,請重新建立容器。
  • 未顯示任何已取得的模型: 請在 models.default 中保留一個當前的識別碼,確認 baseURL/v1 結尾,並檢查 API 容器日誌。
  • LibreChat 忽略已編輯的 YAML: 請確認磁碟區掛載中的主機路徑和容器路徑均指向您所更改的檔案。

有關共享協議行為,請使用 LLM API 快速入門。有關請求及回應欄位,請使用 Chat Completions API 參考