5 分鐘完成 Open WebUI OpenAI 相容 API 設定
要使用 Open WebUI 的 OpenAI 相容 API 設定,你只需新增一組包含 Base URL 和金鑰的連線,模型就會出現在選擇器中。以下是 Abliterated API 的完整設定,從 Docker 到首次聊天。
更新

重點摘要
- Base URL 為 https://api.abliteratedapi.com/v1,模型 ID 為
uncensored。 - 請在管理員連線設定中新增,或將 OPENAI_API_BASE_URL 和 OPENAI_API_KEY 傳入 Docker。
- 先使用 curl 測試金鑰,以便區分是金鑰問題還是 UI 問題。
- Open WebUI 僅為前端:你為模型讀取與寫入的 token 付費,且無需綁定信用卡即可開始使用。
簡短版本
如果你想要一段話搞定 Open WebUI 的 OpenAI 相容 API 設定:開啟管理員設定,新增 OpenAI API 連線,將 URL 設為 https://api.abliteratedapi.com/v1,貼上你的金鑰,儲存,然後選擇名為 uncensored 的模型。就是這些。Open WebUI 可與任何實作 OpenAI 聊天完成格式的服務連線,此 API 即符合該格式。
該服務是一項託管的 OpenAI 相容文字 API,運行單一開放權重模型,針對合法成人用途調整為無內容審查的回應模式。由獨立供應商運營,並非任何模型實驗室官方的 API。Open WebUI 只是您指向它的聊天前端。
開始之前
- API 金鑰。 前往 API 金鑰頁面 建立。註冊可使用 Google 帳號,或使用電子郵件與密碼。新用戶可在此頁面一鍵領取 $0.50 試用額度,有效期 7 天且無需信用卡。
- 正在運行的 Open WebUI。 Docker 安裝或 pip 安裝皆可。以下步驟涵蓋 Docker 與設定畫面。
- 網路存取 從運行 Open WebUI 的機器到
api.abliteratedapi.com的 HTTPS 連線。
在操作 UI 前先檢查金鑰。如果此呼叫回傳包含 uncensored 的清單,表示金鑰與 URL 正確:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
然後確認實際的完成回應是否正常運作:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'方法 1:在設定中新增連線
這是最簡單的路徑,適用於現有安裝。選單標籤在不同 Open WebUI 版本中位置可能不同,因此以下名稱可能略有差異。
- 以管理員身分登入 Open WebUI,開啟 管理員面板,接著進入 設定,再進入 連線。
- 找到 OpenAI API 區塊,並使用加號按鈕新增連線。
- 在 URL 欄位輸入
https://api.abliteratedapi.com/v1。停在/v1即可。不要新增/chat/completions;Open WebUI 會自行附加路徑。 - 將您的金鑰貼上至金鑰欄位。它會以
Authorization: Bearer <key>方式傳送。 - 如果您的版本有驗證按鈕,請使用欄位旁的驗證按鈕,然後儲存。
開啟新聊天並開啟模型選擇器。模型 uncensored 應出現在列表中,因為 Open WebUI 會從 GET /v1/models 讀取它。如果列表保持空白,請前往下方的故障排除區段。
方法 2:在啟動時透過 Docker 設定
對於全新安裝,請將端點作為環境變數傳入。Open WebUI 在啟動時會讀取 OPENAI_API_BASE_URL 和 OPENAI_API_KEY。
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
然後造訪 http://localhost:3000,建立第一個帳戶(它將成為管理員)並開始聊天。命名磁碟區會在更新容器時保留您的對話與設定。
有一件事常讓人措手不及:許多 Open WebUI 設定在首次啟動後會儲存至資料庫,且儲存的值會優先於之後的環境變數。如果你在 Docker 中更改了金鑰或 URL 但無反應,請改為在「連線」畫面中更改,或重設儲存的設定。
值得調整的設定
一旦聊天運作正常,幾項選項可提升體驗並讓帳單可預測。
合理使用上下文視窗
上下文視窗為 100,000 token,提示詞與回覆共用。Open WebUI 會在每則訊息時重新傳送聊天歷史,因此長對話會隨著輪次變得更昂貴。每 1M 輸入 token 費用為 $0.15,傳送 20,000 token 的歷史僅需 $0.003,這很便宜,但在數千則訊息後會累積起來。針對新主題請開始新對話。
串流輸出與取樣
Open WebUI 預設會串流輸出回覆,且 API 支援透過 SSE 進行串流輸出。在進階參數中,你可以設定 temperature、top_p、停止序列、用於產生可重複輸出的 seed 以及懲罰因子。這些參數會直接傳遞給模型。除非你要設定硬性上限,否則請將 max_tokens 留空,因為它是選填項。
背景工作
Open WebUI 可在背景進行額外的模型呼叫,例如為聊天命名。每一項都是實際的請求,會消耗您的額度並計入限制。如果您注意到非您輸入的呼叫,請查看任務模型設定,將其指向您願意付費的模型,或關閉輔助功能。
預設值與系統提示詞
Open WebUI 允許你在工作區區塊儲存模型預設值:包含名稱、基礎模型、系統提示詞與預設參數。為每個你經常執行的任務建立一個,例如基於 uncensored 的編輯助手、程式碼審查員或互動小說會話的角色。簡短的系統提示詞說明角色、語氣與回覆格式,比將長篇指示貼入每次聊天更有效。
這就是模型的優勢所在。它是一個開放權重模型,針對合法成人用途調整為無內容審查的回應模式,適合小說、角色扮演與成人陪伴型應用程式,因為在場景中途出現審查會中斷流程。它不會改變硬性限制:永遠不允許涉及未成年人的性內容。請確保預設值與共用執行個體符合該規則及您所在地的法律。
如果其他人使用你的 Open WebUI 實例,請記住他們都共用你的金鑰與限制。完整金鑰允許 8 個並行請求,因此少數活躍用戶沒問題,但如果大量群組同時聊天可能會達到上限。為每個人或團隊提供專屬金鑰可分散負載,並讓餘額更易於追蹤。
運行成本
您僅按 token 付費,從預付額度扣除:每 1M 輸入 token 為 $0.15,每 1M 輸出 token 為 $0.50。失敗或被拒絕的請求不會收費,且額度永不過期。典型聊天訊息包含 3,000 token 歷史與 400 token 回覆,成本為 $0.00045 + $0.0002 = $0.00065,因此 $10 的用量約為 15,000 則訊息。
儲值金額介於 $20 至 $500,可為任意整數金額,滿 $50 加贈 5%、滿 $100 加贈 10%、滿 $200 加贈 15%。你可使用加密貨幣(TRC20 上的 USDT、Base 上的 USDC)付款。詳情請見定價頁面。剩餘餘額會出現在每個 API 回應的 X-Balance-USD 標頭中,方便你從腳本監控。
故障排除
| 症狀 | 可能原因 | 修復方法 |
|---|---|---|
| 模型列表為空 | URL 或金鑰錯誤 | 執行 /v1/models 的 curl 測試。URL 必須以 /v1 結尾。 |
| Docker 連線被拒絕或超時 | 容器無出站 HTTPS | 檢查主機的 DNS、代理與防火牆設定。 |
| 每則訊息都出現驗證錯誤 | 金鑰貼上時帶有空白,或為舊金鑰 | 請從金鑰頁面重新複製金鑰並再次儲存。 |
| 多人同時聊天時的錯誤 | 速率限制 | 完整金鑰允許 8 個並行請求與每分鐘 300 個;試用金鑰允許 2 個與 60 個。 |
| 長對話停止運作 | 上下文視窗已滿 | 視窗容量為 100,000 個 token。請開始新對話或進行摘要。 |
如果 curl 測試通過但 Open WebUI 失敗,問題出在前端設定。如果 curl 失敗,請先檢查你的金鑰與餘額。快速入門文件 列出了所有請求參數,而關於 無審查聊天 API 是什麼以及不是什麼 的文章則說明了模型的範圍,包括硬性限制:不包含涉及未成年人的性內容。
更多指南
問答
我在 Open WebUI 中要輸入什麼 URL?
使用 https://api.abliteratedapi.com/v1,後面不要加任何字。Open WebUI 會自動加上 /chat/completions 和 /models。
我要選擇哪個模型名稱?
模型 ID 為 uncensored。連接儲存且模型列表載入後,它會出現在模型選擇器中。
試用需要信用卡嗎?
否。新用戶在註冊後,可於 API 金鑰頁面一鍵領取 $0.50 試用額度。有效期 7 天,無需信用卡。
我可以與本地模型同時運行嗎?
可以。Open WebUI 支援多個連接同時運作,因此這個端點可以與本地模型並存,且每個都會顯示在同一個模型選擇器中。
我的對話會被用於訓練嗎?
不會。傳送至 API 的提示詞不會被用於訓練。由 Open WebUI 儲存的對話歷史會保留在您自己的安裝環境中。