開啟 WebUI API 設定

Open WebUI 透過協定管理模型服務，而不需要為每個提供者提供單獨的插件。將 TokenHub 加入為 OpenAI API Connection。然後，Open WebUI 將 /models 和 /chat/completions 附加到 API 基礎 URL。

在管理連線下新增 TokenHub

這遵循 Open WebUI 的官方 Step 1: Add Your Provider Connection 序列：

1. 使用管理員帳號登入Open WebUI。
2. 轉到 Settings → Admin → Connections。
3. 找到 Manage OpenAI API Connections 並點擊 Add Connection（加號按鈕）。
4. 在URL中輸入https://us-api.tokenhub.com/v1。
5. 在 API Key 中輸入您的 TokenHub API 金鑰。
6. 如果連線驗證未傳回任何型號，請在 Model IDs (Filter) 下輸入準確的 TokenHub 型號 ID，然後按一下加號按鈕將其新增至白名單。
7. 按一下“Save”。

請勿將 /chat/completions 放入 URL 中。 Open WebUI 附加請求路徑本身，因此完整請求 URL 會建立重複的路徑。

了解驗證連接和型號 ID（過濾器）

在儲存之前，Open WebUI 會向提供者的 /models 端點發送標準承載令牌請求。其文件指出，即使聊天完成有效，某些相容服務也會向此發現請求傳回 400、401 或 403。按此順序測試：

1. 在**Model IDs (Filter)**下手動新增型號ID並儲存。
2. 開始新的聊天並確認模型出現在選擇器中。
3. 選擇它並發送一條訊息，以便您可以測試實際的聊天完成請求。

每個型號 ID 僅新增一次。 Open WebUI 修剪周圍的空白。連接旁邊的開關會暫時停用提供程序，但不會刪除其設定。

請勿用 host.docker.internal 取代遠端 API

官方的 host.docker.internal 提示僅適用於 Open WebUI 容器必須到達在 Docker 主機上執行的模型伺服器的情況。 TokenHub 是遠端 HTTPS 服務，因此保留 https://us-api.tokenhub.com/v1。如果僅容器逾時，請檢查其 DNS 解析度、出站 HTTPS 存取和代理配置，而不是將 URL 變更為 localhost。

验证Open WebUI实际发送的请求

1. 建立聊天並選擇您新增到白名單的 TokenHub 型號。
2. 首先發送一條簡短的純文字訊息。
3. 在TokenHub请求日志中，确认路径为/v1/chat/completions，型号ID准确，并记录使用情况。
4. 只有在基本的聊天運作正常後，才能分別測試工具、圖像和知識功能。 Open WebUI 中的控制不保證所選型號或相容端點支援此功能。

對於 404，首先確認 URL 以 /v1 結尾。如果型號缺失，返回Model IDs (Filter)。如果故障僅發生在Docker中，請檢查容器網路。

官方參考

• Open WebUI：连接 OpenAI-compatible 提供商