開始前你需要準備的
一個 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。依此填入:
- 將你的金鑰貼到API 金鑰欄位中。
- 將Organization ID留空。
- 將預設的Base URL替換為
https://api.onekeyllmapi.com/v1。保留結尾的/v1,不要新增/chat/completions。 - 儲存。n8n 在儲存時會執行一個小型測試呼叫;如果失敗,請跳轉到下面的故障排除部分。
每個環境保留一個憑證。如果您運行預發和生產環境的 n8n,請為每個環境提供專屬的金鑰,以便分別查看支出,且撤銷其中一個不會影響另一個。
步驟 2:建立簡單的聊天工作流程
從證明連接的最小事物開始:一個手動觸發器和一個模型呼叫。
- 新增一個Manual Trigger 節點。
- 新增一個OpenAI 節點(或 Basic LLM Chain 內的OpenAI Chat Model 子節點,視你的 n8n 版本而定),並選取步驟 1 的憑證。
- 對於模型,尋找手動輸入 ID 的方式。較新的 n8n 版本在列表旁提供By ID 模式。在那裡輸入
uncensored。列表可能為空,或僅顯示 OpenAI 的名稱,因為 n8n 會在其端進行篩選。 - 加入提示詞,例如 將此支援工單摘要為兩句話,然後執行該節點。
如果你的 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 開頭 |
| 404 | Base 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一文,其使用的客戶端設定相同。
