開發者資源
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
開啟應用程式，建立管理員帳戶並登入後，再新增連線。
新增 RunAPI 連線
- 開啟 Admin Settings → Connections → OpenAI，然後選取 Add Connection。
- 將 URL 設為
https://runapi.ai/v1，並輸入您的 RunAPI API 金鑰。 - 第一次嘗試連線時，請將 Model IDs (Filter) 留空，讓 Open WebUI 自動探索可用的模型。
- 儲存連線並等待驗證完成。
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/v1URL，但對其他本機連線則有影響。
如需共用協定行為，請參閱 LLM API 快速入門。如需請求與回應欄位，請參閱 Chat Completions API 參考。