OpenWebUI 有 API 嗎？有，兩種方向

人們所指的兩種不同 API

當有人詢問 Open WebUI 是否有 API 時，他們可能是在詢問兩種方向之一。混淆它們是設定指南讓人感到困惑的主要原因，因此最好先將它們分開。

• 入站：你的程式將請求發送到 Open WebUI。它作為伺服器運作，具有聊天、模型和文件的端點，由你在應用程式內生成的 API 金鑰保護。
• 出站：Open WebUI 向模型伺服器發送請求，使其聊天視窗有內容可對話。這是你在管理設定中配置的連線。

因此簡短的答案是兩者皆可。該專案記錄了一個具有 OpenAI 風格聊天端點的 API，並支援連接任何支援 OpenAI 協議的伺服器。確切的路徑和金鑰處理方式可能會因版本而異，因此請檢查你所運行版本的文件。

本站提供出站側的模型：一個託管的、相容 OpenAI 的文字 API，單一模型 ID 為 uncensored。它不是 Open WebUI，也不為你運行它。Open WebUI 是你自行託管的軟體。

使用 Open WebUI 自己的 API

Open WebUI 允許登入用戶在帳戶設定中建立 API 金鑰。使用該金鑰，你可以從腳本呼叫其端點。聊天端點遵循 OpenAI 的格式，因此現有的客戶端程式碼通常可以指向它。專案在撰寫時記錄的路由是 /api/chat/completions；請根據你的版本進行確認。

Copy# Open WebUI running locally on port 3000, key created in Settings > Account
curl http://localhost:3000/api/chat/completions \
  -H "Authorization: Bearer $OPENWEBUI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Summarize this scene in one line."}]}'

請注意，此處模型名稱取決於 Open WebUI 已註冊的模型。若你已將此 API 連接為後端，該名稱為 uncensored。此請求中的金鑰是 Open WebUI 金鑰，而非模型 API 金鑰。這是兩組獨立憑證，負責不同的任務。

為什麼要使用入站 API？當你想要在程式後方使用 Open WebUI 的額外功能時很有用，例如已儲存的知識庫、每個用戶的帳戶或模型預設值，並且你希望在不使用瀏覽器的情況下訪問它們。

使用外部 API 作為後端

另一個方向是大多數人需要的方向。Open WebUI 有一個用於相容 OpenAI 連線的部分，你可以在其中輸入 URL 和金鑰。對於此服務，值為：

• URL：https://api.nsfwvideo.top/v1
• 金鑰：來自 金鑰頁面
• 模型：uncensored，透過 GET /v1/models 自動發現

逐步操作：開啟管理設定，前往連線，新增 OpenAI API 連線，貼上 URL 和金鑰，儲存，並在新聊天中選擇模型。如果你偏好從命令列開始，請在啟動容器時設定環境變數 OPENAI_API_BASE_URL 和 OPENAI_API_KEY。

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.nsfwvideo.top/v1 \
  -e OPENAI_API_KEY=$API_KEY \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main

請注意，Open WebUI 在首次啟動時會將許多設定儲存到其資料庫中。如果你後來更改了環境變數但沒有生效，請在管理面板中編輯連線。快速入門 提供了後端所需的請求格式，如果你希望使用 curl 進行驗證。

串接兩者

你可以同時使用兩個方向。你的應用程式使用 Open WebUI 金鑰呼叫 Open WebUI 的入站 API，Open WebUI 將聊天轉發到你配置的後端，然後回覆流回。這種安排在以下情況下有意義：團隊已經運行帶有帳戶的 Open WebUI，並希望腳本共享其預設值；或者你想要一個同時包含人類和程式角色設定的地方。

這會增加一個跳躍。每個請求現在都會先經過你的 Open WebUI 伺服器，然後才到達模型 API，因此需要額外維護一個需要持續運行、更新修補並確保安全的服務。速率限制也會以不易察覺的方式疊加：後端金鑰允許 8 個並行請求，完整金鑰每分鐘允許 300 個請求，而所有透過你的 Open WebUI 執行個體進來的使用者和腳本都共用這些額度。如果後端回傳 HTTP 429，錯誤程式碼為 rate_limited 或 concurrency，失敗通常會以錯誤的形式出現在 Open WebUI 和你的呼叫端。

何時跳過 Open WebUI 直接呼叫 API

如果你只需要一個生成文本的腳本，例如大綱、鏡頭描述或草稿旁白，則不需要 Open WebUI。此服務是一個普通的相容 OpenAI 端點，因此標準 SDK 可以直接與之通訊。

Copyimport os
from openai import OpenAI

client = OpenAI(base_url="https://api.nsfwvideo.top/v1", api_key=os.environ["API_KEY"])

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write concise shot lists for short films."},
        {"role": "user", "content": "Shot list for a ninety second chase through a night market."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)

直接呼叫可提供 SSE 串流輸出、函式呼叫、JSON 模式以及所有採樣參數，且無中間層。若你需要供人使用的聊天介面，具備歷史記錄、帳號和預設設定，Open WebUI 是更好的選擇。若用於批次工作，腳本是更好的選擇。API 僅產生文字：不渲染影片、影像或音訊，因此對於影片專案，它提供其他工具的腳本和提示詞等文字內容。影片管線頁面深入探討此用途。

快速決策指南

• 你想為你自己或團隊提供聊天視窗：運行 Open WebUI 並添加出站連線。
• 你想讓腳本重用 Open WebUI 預設值或帳戶：使用其入站 API 和 Open WebUI 金鑰。
• 你想進行批量文本生成：使用 OpenAI SDK 直接呼叫模型 API 並跳過額外層。
• 你想要圖像或語音：Open WebUI 或此文字 API 無法單獨產生它們。為此步驟連接單獨的工具。

無論你選擇哪條路徑，模型端的條件都相同：提示詞與回覆共用 100,000 token 的上下文視窗，支援函式呼叫與 JSON 模式，並且嚴格禁止涉及未成年人的性內容。

暴露任一 API 的安全注意事項

將兩種金鑰都視為機密。Open WebUI 金鑰授予建立該金鑰之用戶在其執行個體內可執行的操作；模型 API 金鑰則會消耗你的預付額度。不要將任一金鑰貼入客戶端程式碼或公開儲存庫。

• 如果 Open WebUI 可從你自己的機器之外訪問，請將其放在 HTTPS 後面。
• 為每個腳本創建單獨的 Open WebUI 金鑰，以便你可以撤銷一個而不破壞其他金鑰。
• 如果模型 API 金鑰出現在日誌或截圖中，請更換金鑰。
• 監視後端的 X-Balance-USD 響應標頭，以查看每次呼叫的支出。

在隱私方面，發送到此 API 的提示詞不會用於訓練。Open WebUI 本身會將聊天歷史儲存於其自身的資料庫中（位於你的伺服器上），因此你的託管選擇決定了誰可以讀取這些內容。

運行此設定的成本

Open WebUI 是你託管的免費軟體；你的成本是伺服器加上 token。token 按每 1M 輸入 $0.15 和每 1M 輸出 $0.50 計費，來自預付額度，無訂閱。進行一次包含 3,000 個輸入 token 和 500 個輸出 token 的對話輪次：3,000 x $0.15 / 1M = $0.00045 用於輸入，500 x $0.50 / 1M = $0.00025 用於輸出，總計 $0.0007。一千次此類對話輪次成本為 $0.70。

儲值金額為 $20 至 $500 之間的任意整數，$50 起享 +5%、$100 起享 +10%、$200 起享 +15%。付款方式為加密貨幣，TRC20 上的 USDT 或 Base 上的 USDC。失敗或遭拒的請求不會扣款，且額度永不過期。新用戶只需一鍵點擊，無需提供付款資訊，即可領取 $0.50 的免費試用額度，有效期為 7 天。請參閱 定價頁面以了解完整資訊。

關於內容的提醒：該模型經過調整，可針對合法成人用途無內容審查地回答，但絕不允許涉及未成年人的性內容。

更多指南

• 用於 NSFW 影片管線的無審查 LLM API