開發者資源
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 參考。