文件

Open WebUI

Open WebUI 會將任何 OpenAI 相容端點視為一個連線。你可以在 Admin Settings 中新增，或在容器啟動時設定兩個環境變數——這兩種方式最後都會建立相同的連線。

在 Admin Settings 中新增一個 OpenAI 連線，或在容器啟動時設定 OPENAI_API_BASE_URL 與 OPENAI_API_KEY — 兩者最終都指向同一個 /v1。

連線，或 docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

填入 Model IDs (Filter)。未填寫時，選擇器會列出整個目錄，包括聊天視窗無法呼叫的圖片、影片和音樂模型，使用者第一次點選就可能選到其中一個。當端點沒有 /models 路由時，也應使用這項篩選設定；Kunavo 有提供該路由，因此兩種方式都能通過驗證。

URL 必須保留 /v1。如果 Open WebUI 在 Docker 中執行，而你要連到同一主機上的服務，請將 localhost 替換為 host.docker.internal——託管端點不適用這項替換，但這正是使用者接著最常遇到的問題。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Open WebUI 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
在 Open WebUI 中前往 Settings → Admin → Connections，然後找到 Manage OpenAI API Connections。
點選 ➕ Add Connection，輸入 URL 和 API Key。
在 Model IDs (Filter) 中加入想使用的 ID，接著儲存並等待連線完成驗證。
開始新的聊天——模型會以連線名稱為前綴，顯示在選擇器中。

已於 2026年9月6日根據 Open WebUI 的 OpenAI 相容 provider 指南進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Open WebUI 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

模型 ID	Kunavo 輸入／輸出	它在 Open WebUI 中的位置
`claude-sonnet-5`	$1.40 / $7.00	一般聊天的預設模型
`claude-opus-5`	$3.50 / $17.50	長篇分析對話
`claude-haiku-4-5`	$0.70 / $3.50	快速、便宜，足以應付大多數回合
`gpt-5-6-terra`	$0.70 / $4.20	貼入聊天視窗的長篇文件

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

常見問題

如何將 Open WebUI 連接至 OpenAI 相容 API？

前往 Settings → Admin → Connections，開啟「Manage OpenAI API Connections」並點選 Add Connection，然後輸入端點 URL——也就是 /v1 根路徑——以及 API key。也可以在容器啟動時設定 OPENAI_API_BASE_URL 和 OPENAI_API_KEY 環境變數。兩種方式都會建立相同的連線。

Open WebUI 中的 Model IDs (Filter) 有什麼用途？

此設定會限制該連線的哪些模型 ID 顯示在選擇器中；對於未實作 /models 路由的端點，它也可作為替代方案——你可以手動新增 ID，即使驗證失敗，聊天功能仍可使用。若 gateway 提供大型多模態目錄，無論如何都建議設定此項，讓聊天選擇器只列出聊天視窗實際能呼叫的模型。

Open WebUI 的 base URL 要包含 /v1 嗎？

要。Open WebUI 只會在你提供的 URL 後附加路由，因此連線 URL 應為 /v1 根路徑——https://api.example.com/v1。文件中的端點範例也都帶有這個尾碼。若省略，連線可以儲存，但每個請求都會收到 404。

Open WebUI 可以使用 Claude 和 GPT 模型嗎？

可以，只要這些模型透過 OpenAI 相容端點提供。Open WebUI 會將模型 ID 原樣傳送至連線 URL，因此任何供應商的 ID 都會由端點解析，而非由 Open WebUI 處理。這也表示只要一個連線和一組金鑰，就能讓 Claude 和 GPT ID 同時出現在同一個模型選擇器中。