繁中 ▾
取得 API 金鑰

n8n 中的 OpenAI 相容 API:設定指南

如果你搜尋 openai compatible api n8n,簡短的答案是你只需在 OpenAI 憑證中更改兩個值:Base URL 和 API 金鑰。工作流程的其餘部分與任何 OpenAI 節點相同。

更新於

等距自動化工作流程,連接區塊將資料傳送至 API 終端

重點摘要

開始前你需要準備的

一個 n8n 執行個體(雲端或自託管)以及來自此服務的 API 金鑰。如果你還沒有金鑰,API 金鑰頁面會引導你使用 Google 或電子郵件與密碼進行註冊。新用戶可以在該頁面點擊一次即可領取 $0.50 的試用額度,有效期為 7 天且無需綁定信用卡。

三個值會輸入到 n8n:

  • Base URL: https://api.onekeyllmapi.com/v1
  • API 金鑰: 以 Authorization: Bearer <key> 的形式傳送,n8n 會自動為你完成此動作
  • 模型 ID: uncensored

此服務是一個託管的純文字 LLM API,遵循 OpenAI 的請求格式,適用於 /v1/chat/completions、/v1/responses 和 /v1/models。它並非任何模型供應商的官方 API,因此只要 n8n 發送至 OpenAI 聊天端點的是文字請求,在此皆可運作。

步驟 1:建立憑證

在 n8n 中開啟Credentials,選擇Create credential 並搜尋OpenAI API。依此填入:

  1. 將你的金鑰貼到API 金鑰欄位中。
  2. 將Organization ID留空。
  3. 將預設的Base URL替換為https://api.onekeyllmapi.com/v1。保留結尾的/v1,不要新增/chat/completions。
  4. 儲存。n8n 在儲存時會執行一個小型測試呼叫;如果失敗,請跳轉到下面的故障排除部分。

每個環境保留一個憑證。如果您運行預發和生產環境的 n8n,請為每個環境提供專屬的金鑰,以便分別查看支出,且撤銷其中一個不會影響另一個。

步驟 2:建立簡單的聊天工作流程

從證明連接的最小事物開始:一個手動觸發器和一個模型呼叫。

  1. 新增一個Manual Trigger 節點。
  2. 新增一個OpenAI 節點(或 Basic LLM Chain 內的OpenAI Chat Model 子節點,視你的 n8n 版本而定),並選取步驟 1 的憑證。
  3. 對於模型,尋找手動輸入 ID 的方式。較新的 n8n 版本在列表旁提供By ID 模式。在那裡輸入uncensored。列表可能為空,或僅顯示 OpenAI 的名稱,因為 n8n 會在其端進行篩選。
  4. 加入提示詞,例如 將此支援工單摘要為兩句話,然後執行該節點。

如果你的 n8n 版本堅持要從列表中選擇,請使用下一節中的 HTTP 請求方法。它始終有效,因為你可以控制整個請求。

使用 HTTP Request 節點呼叫 API

HTTP 請求節點是從 n8n 呼叫此 API 的最可預測方式,它暴露了 API 接受的所有參數,包括 seed、stop、top_p 和 tools。像這樣配置它:

  • 方法:POST
  • URL:https://api.onekeyllmapi.com/v1/chat/completions
  • 驗證方式:通用憑證類型搭配標頭驗證,名稱Authorization,值Bearer YOUR_KEY
  • 發送主體:開啟,內容類型 JSON

Body(若要在欄位中插入來自先前節點的資料,請將欄位切換為Expression):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

回覆文字位於 choices[0].message.content。在下一個節點中,你可以使用 {{ $json.choices[0].message.content }} 引用它。

要首先在 n8n 之外測試相同的請求,請在終端機中執行此命令:

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

如果 curl 運作正常但 n8n 不行,則問題出在節點設定中,而不是您的金鑰或餘額。

用於解析輸出的 JSON 模式

當模型將資料包裝成易讀的散文時,工作流程就會出錯。JSON 模式要求 API 回傳有效的 JSON 物件,你可以將其直接傳遞給Set 或IF 節點。在 body 中加入response_format:

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

兩個習慣可確保可靠性。首先,在提示詞中明確指出 JSON 並命名鍵,因為 JSON 模式保證語法,而非你的 schema。其次,回覆仍以字串形式出現在message.content中,因此在讀取欄位之前,請新增一個Code 節點或使用帶有JSON.parse()的運算式。在 OpenAI 節點中,相同的切換選項出現在節點選項下的回應格式。

處理 429 和其他錯誤

n8n 並行執行項目,因此 50 列的批次可能很快觸及限制。完整金鑰允許 8 個並行請求和每分鐘 300 個請求;試用金鑰允許 2 個和 60 個。當你超過限制時,API 會以 HTTP 429 回應,代碼為rate_limited(每分鐘請求過多)或concurrency(同時請求過多)。在暫時過載時,你會收到帶有Retry-After: 5標頭的 429 回應。

n8n 中的實用設定:

  • 開啟節點,前往Settings,啟用Retry On Fail,將Max Tries設為 3 或 4,並將Wait Between Tries設為 5000 ms。
  • 在模型呼叫之前放置一個Loop Over Items 節點(批次大小為 4 到 6),以便保持在 8 個並行請求以下。
  • 在節點Settings下,On Error 可設定為以錯誤輸出繼續,這樣一個錯誤的列就不會停止執行。

若要更深入地了解這兩種限制,請閱讀 API 文件。其他錯誤很簡單:401 表示金鑰錯誤或標頭缺少字詞 Bearer,而 404 通常表示 Base URL 有錯字或額外的路徑段。

疑難排解檢查清單

大多數故障來自少數幾個原因。在懷疑服務之前,請由上至下逐一排查。

症狀可能原因修復方法
儲存或運行時出現 401金鑰錯誤,或標頭缺少 Bearer再次貼上金鑰;在 Header Auth 中,值必須以 Bearer 開頭
404Base URL 有錯字或額外的路徑在憑證中精確使用 https://api.onekeyllmapi.com/v1
找不到模型模型 ID 未以 uncensored 形式輸入切換至「依 ID」,或使用 HTTP 請求節點
429 錯誤(並行限制)超過 8 個平行執行(試用金鑰限 2 個)搭配「迴圈遍歷項目」批次處理並加入重試機制
下游 JSON 解析錯誤回覆為字串,或提示詞未指定金鑰使用 JSON.parse() 解析,並在系統提示詞中描述金鑰

聯繫支援時,請附上失敗請求的 X-Request-Id 回應標頭。在 n8n 中,您可以在 HTTP 請求節點選項中開啟 包含回應標頭與狀態來查看標頭。

以較低成本進行測試

在開發階段使用試用額度。由於試用金鑰僅限 2 個並行請求且每分鐘 60 個請求,批次處理時速度較慢,但用於檢查憑證、提示詞和解析邏輯已足夠。當您將工作流程排程化時,請切換至完整金鑰。

成本與合理的工作流程設計

計費方式為依用量付費:輸入 token 每 100 萬個 $0.15,輸出 token 每 100 萬個 $0.50,從預付額度扣除。每天處理 1,000 封電子郵件的工作流程,每封郵件 600 個輸入 token 和 100 個輸出 token,將使用 0.6M 輸入 token($0.09)和 0.1M 輸出 token($0.05),每日約 $0.14。失敗或被拒絕的請求不會計費,因此錯誤重試不會使費用加倍。詳情請見 定價頁面。

保持提示詞簡短,僅傳送模型所需的欄位,並在確定答案簡短時設定 max_tokens。如果你也在本機執行模型,請參閱透過 OpenAI 風格 API 使用本機 LLM一文,其使用的客戶端設定相同。

問答

哪些 n8n 節點支援自訂 Base URL?

任何使用 OpenAI 憑證的節點均可使用,因為 Base URL 欄位屬於憑證的一部分。如果某個節點未提供您需要的參數,請使用 HTTP 請求節點。

為什麼 n8n 中的模型清單為空或錯誤?

n8n 會在其側載入並過濾清單。請手動輸入模型 ID uncensored,或使用 HTTP 請求節點,在該節點中模型僅為內文中的一個欄位。

我可以在 n8n 中使用串流輸出嗎?

API 支援透過 SSE 進行串流,但大多數 n8n 節點會等待完整回覆後才傳遞資料。對於工作流程,使用一般的非串流呼叫較為簡單。

我如何從工作流程檢查餘額?

呼叫 GET /v1/balance,或在任何回應中讀取 X-Balance-USD 標頭,並新增一個 IF 節點,當餘額低於閾值時向你發出警報。

只需填寫表單即可取得金鑰

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