開發者資源

Open WebUI

安裝 Open WebUI，將 RunAPI 新增為 OpenAI 相容連接，選擇模型，並驗證聊天。

透過 OpenAI 相容連接將 Open WebUI 連接至 RunAPI。您需要 Open WebUI 管理員存取權限及來自身份驗證指南的標準 RunAPI API 金鑰。

安裝 Open WebUI

請依照適用於您平台的官方 Open WebUI 快速入門進行操作。如需本機 Docker 安裝，可使用以下命令啟動官方映像：

SHELL

docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

開啟應用程式，建立管理員帳戶，並在添加連線之前登入。

Open WebUI 從其後端發送連線檢查，並使用 GET /v1/models 進行探索。RunAPI URL 為公開 HTTPS，因此 Docker 安裝無需為此連線使用 host.docker.internal。

開啟新聊天，並從聊天模型選擇器中選擇 RunAPI 模型。使用模型目錄確認當前模型識別符和功能。

若探索未能填充選擇器，請編輯連接並在 Model IDs (Filter) 下新增確切識別碼。模型探索錯誤與 Chat Completions 錯誤是獨立的訊號；在移除連接前，請先測試手動新增的模型。

傳送簡短提示，例如 Reply with the word connected. 正常的串流或完整回應確認 Open WebUI 可以使用所選的 RunAPI 模型。

驗證返回 401 或 403： 請以來自身份驗證指南的有效標準金鑰替換連線中的 API 金鑰。
未顯示任何 RunAPI 模型： 請確認 URL 以 /v1 結尾，然後將一個當前的識別碼新增至 Model IDs (Filter) 並重試對話。
模型可見但對話失敗： 請在模型目錄中確認該識別碼支援 OpenAI 相容的 Chat Completions，然後檢查 Open WebUI 後端日誌以了解請求狀態。
本機 URL 在瀏覽器中正常但在 Open WebUI 中不正常： Open WebUI 的連線源自其後端。這不影響公共 https://runapi.ai/v1 URL，但對其他本機連線有影響。

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