繁中 ▾

5 分鐘完成 Open WebUI OpenAI 相容 API 設定

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

更新

聊天介面透過發光的電纜連線至託管 API 伺服器,代表 Open WebUI 連線

重點摘要

  • 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 版本中位置可能不同,因此以下名稱可能略有差異。

  1. 以管理員身分登入 Open WebUI,開啟 管理員面板,接著進入 設定,再進入 連線。
  2. 找到 OpenAI API 區塊,並使用加號按鈕新增連線。
  3. 在 URL 欄位輸入 https://api.abliteratedapi.com/v1。停在 /v1 即可。不要新增 /chat/completions;Open WebUI 會自行附加路徑。
  4. 將您的金鑰貼上至金鑰欄位。它會以 Authorization: Bearer <key> 方式傳送。
  5. 如果您的版本有驗證按鈕,請使用欄位旁的驗證按鈕,然後儲存。

開啟新聊天並開啟模型選擇器。模型 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 儲存的對話歷史會保留在您自己的安裝環境中。

只差一張表單,即可取得金鑰

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。

取得 API 金鑰