Open WebUI API 端點：連接無審查 LLM

你需要的值

Open WebUI 僅需要此服務的三個項目。第一個是 Base URL，https://api.dolphinllm.com/v1。第二個是來自您帳戶的 API 金鑰。第三個是模型 ID，uncensored，一旦連線正常，Open WebUI 會自行從模型清單讀取。

涉及兩個端點。GET /v1/models 用於填充模型下拉選單，POST /v1/chat/completions 用於傳送您發送的每則訊息。聊天不需要其他功能。這是文字 API，因此 Open WebUI 的圖片、音訊和嵌入功能在此無處可連。

你不需要信用卡即可試用。註冊後，你可以在金鑰頁面一鍵領取 $0.50 的免費試用額度。該額度有效期為 7 天。

在管理面板中新增連線

如果 Open WebUI 已在執行，這是最快的途徑。

1. 以管理員身分登入並開啟 管理員設定，然後進入 連線。
2. 在 OpenAI API 區段中，按一下加號按鈕以新增連線。
3. 將 https://api.dolphinllm.com/v1 貼上至 URL 欄位，並將你的金鑰貼上至金鑰欄位。
4. 使用欄位旁邊的驗證按鈕。綠色確認表示已回傳模型清單。
5. 儲存、開啟新對話，並從模型選擇器中選擇 uncensored。

Open WebUI 不同版本間的選單名稱略有差異。如果找不到連線，請在設定中搜尋「OpenAI」。欄位始終相同：URL、金鑰，有時還有模型篩選器。

使用 Docker 環境變數進行設定

對於全新安裝，您可以跳過管理員畫面，並在容器啟動時傳遞連線。Open WebUI 在啟動時會讀取 OPENAI_API_BASE_URL 和 OPENAI_API_KEY。

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://api.dolphinllm.com/v1" \
  -e OPENAI_API_KEY="YOUR_KEY" \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

然後瀏覽 http://localhost:3000，建立第一個帳戶（它將成為管理員），模型應該已經列出。如果機器是共用的，請將金鑰排除在 shell 歷史記錄之外：將其放入環境檔案，並使用 --env-file 參數。

某些 Open WebUI 版本將這些變數僅視為初始值。一旦您在 UI 中儲存了連線，儲存的值將優先。如果您更改變數但無反應，請改為在管理員設定中編輯連線。

供多人使用

Open WebUI 有自己的使用者帳戶，因此一個安裝可以服務家庭或小團隊，而伺服器上只有一個 API 金鑰。這很方便但也存在風險：每個使用者都從相同的額度支出。決定誰擁有帳戶，並定期查看 X-Balance-USD，以免長時間的角色扮演讓您的額度意外耗盡。

將金鑰保存在環境變數或機密檔案中，切勿放在截圖或共用文件中。你的金鑰位於 API 金鑰頁面；如果你懷疑金鑰已洩漏，請在取得新金鑰後立即在 Open WebUI 中替換它。對於面向公眾的安裝，請將其置於 HTTPS 後方，並關閉開放註冊，以免陌生人建立帳戶並使用你的額度。

共用設定的一個額外注意事項：該模型經過調整，可在合法成人用途下無內容審查地回答。這是用於小說和私人研究的功能，但也意味著您可以決定內部規則。在共用模型上設定系統提示詞是撰寫規則的最簡單方式。無論提示詞為何，API 上都不允許涉及未成年人的性內容。

此設定的良好用途

將 Open WebUI 連接至無審查端點的人通常希望有一個乾淨的聊天視窗，不受託管聊天機器人的限制。常見用途包括長篇小說和世界觀建構、成人角色扮演和伴侶角色、撰寫主流助手拒絕處理的材料，以及一般的程式設計或寫作協助。同一個模型可處理所有這些任務，因此您可以在一個對話中切換任務。

Open WebUI 在幾個特定方面提供協助。已儲存的提示詞和模型預設設定可讓你透過一鍵快速存取特定角色或編輯器人格。文件上傳和網頁搜尋功能（在你啟用時）會將額外文字送入提示詞，這會增加 token 用量，因此請留意你附加內容的大小。聊天資料夾和搜尋功能讓你輕鬆回到長期專案。

它無法透過此連線產生圖片、語音或影片，因為 API 僅限文字。

在歸咎 Open WebUI 之前先測試端點

大多數設定失敗來自 URL 的打字錯誤或過期的金鑰，這兩者在終端機中會更快顯示。從託管 Open WebUI 的機器執行這兩個呼叫。

Copycurl https://api.dolphinllm.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

curl https://api.dolphinllm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

第一個呼叫應列出 uncensored。第二個應回傳正常的聊天完成結果。檢查回應標頭：X-Balance-USD 顯示帳戶剩餘金額，這是確認 Open WebUI 是否使用您認為的金鑰支出的方便方法。

完整參數清單位於 API 文件。

值得為聊天變更的設定

系統提示詞和採樣

Open WebUI 允許你為每個模型或每個聊天設定系統提示詞。由於該模型經過調整，可在合法成人用途下無內容審查地回答，因此一段簡短的系統提示詞（用於固定語調、人格或輸出格式）比一長串規則更有效。Temperature、top_p、stop、seed 與懲罰參數都會直接傳遞，所以 Open WebUI 中的滑桿確實會產生作用。

上下文長度

上下文視窗為 100,000 token（提示詞加完成內容）。長對話會在每次輪次中增加提示詞，且您每次都要為整個歷史記錄付費。如果對話變重，請開始新對話或總結舊對話。

背景請求

Open WebUI 會在背景發送額外的請求來處理聊天標題與標籤，預設使用相同的模型。試用金鑰允許 2 個並行請求與每分鐘 60 次，這些請求可能會擠佔你實際訊息的資源。關閉標題與標籤的生成，或接受短暫停頓。完整金鑰允許 8 個並行請求與每分鐘 300 次，對於個人或小團隊安裝來說已足夠。

串流輸出、JSON 模式和工具

Open WebUI 預設會串流輸出回覆，API 支援伺服器發送的事件（stream: true），並在串流結尾提供用量區塊。你可以看到文字以 token 為單位逐個顯示，最終回應的餘額標頭會反映你的花費。

API 也支援函式呼叫：tools、tool_choice、串流輸出的 tool_calls，以及以 role: "tool" 格式回傳的結果。Open WebUI 提供這些功能的程度取決於其版本以及你安裝的工具或函式，因此在建立工作流程前，請先使用一個小型工具進行測試。JSON 模式（response_format 設為 json_object）在從腳本呼叫相同端點且搭配聊天介面時非常實用。

一個實用模式是讓 Open WebUI 供人使用，並使用相同的金鑰從腳本進行批次工作。兩者都經過相同的 Base URL，因此一個餘額涵蓋所有內容。請記住，限制適用於每個金鑰：完整金鑰允許 8 個並行請求，在 UI 和您的腳本之間共用。

常見錯誤與修復

• 沒有出現模型。 URL 可能缺少 /v1 或有拼寫錯誤。請與上方的值逐字比較，並移除任何結尾的斜線。
• 驗證錯誤。 金鑰在貼上時帶有前置或後置空白，或該金鑰屬於已刪除的帳號。請再次從金鑰頁面複製。
• 模型選擇器顯示錯誤的清單。 Open WebUI 也會查詢您新增的其他連線，例如本機 Ollama。停用您不使用的連線。
• 串流輸出中途停止顯示。 Open WebUI 前方的反向代理伺服器可能會緩衝伺服器發送的事件。請關閉該路由的緩衝功能。
• 餘額偏低。 在歸零前請進行儲值。失敗或被拒絕的請求不會收費，因此你只需為已交付的完成內容付費。

此 API 的聊天介面成本

定價為每 1M 輸入 token $0.15，每 1M 輸出 token $0.50，從預付額度扣除。以中等長度聊天中的一個典型回合為例：輸入 4,000 個 token 的歷史，輸出 500 個 token。輸入成本為 4,000 x $0.15 / 1,000,000 = $0.0006。輸出成本為 500 x $0.50 / 1,000,000 = $0.00025。該回合成本為 $0.00085。

以該速率計算，$0.50 的試用額度可涵蓋約 588 次對話，而 $20 的儲值可涵蓋約 23,500 次。請參閱 定價頁面 以了解儲值贈點。若你想在 Open WebUI 之外使用同一個金鑰，例如在不需要登入介面的腳本中，請參閱 無登入限制的 LLM 使用指南。

更多指南

• 免費 LLM API 供開發者使用：試用與按量付費
• 如何無登入限制使用 LLM