n8n

OpenAI 憑證的 Base URL 欄位 — https://api.kunavo.com/v1，保留 /v1 — 可讓 n8n 工作流程中的所有 OpenAI Chat Model 使用 Kunavo；模型節點本身沒有端點欄位。

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在 n8n 中，建立一組類型為 OpenAI 的認證。在 API Key 欄位填入金鑰，將 Organization ID (optional) 留空，並將 Base URL 的預設值 https://api.openai.com/v1 替換為 https://api.kunavo.com/v1。然後儲存。
3. 新增 AI Agent 或 Basic LLM Chain 節點，並連接使用該認證的 OpenAI Chat Model 子節點。將 Model 欄位從 From List 切換為 ID，並依照 GET /v1/models 列出的方式輸入 ID，例如 claude-sonnet-5 — 清單也可以使用，但手動輸入 ID 能讓工作流程更容易閱讀。
4. 決定是否啟用 Use Responses API：除非鏈中的工具需要 Chat Completions，或你希望 n8n 執行記錄顯示 chat-completions 請求，否則請保持啟用。
5. 先用一行提示執行一次工作流程，再將它連接到觸發器。401 表示金鑰有問題；若出現代碼為 missing_v1_prefix 的 404（或在較舊的執行結果中，訊息以 <!DOCTYPE html> 開頭），表示基礎 URL 遺漏了 /v1。

已於 2026年10月1日 根據 n8n 在標籤 n8n@2.41.4 的 OpenAI 認證原始碼 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 n8n 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

為什麼基礎 URL 設在認證中

較舊的教學會在模型節點內設定端點。已發布的原始碼中，從節點 1.1 版起，節點內的 Base URL 選項便已隱藏，因此你今天新增的節點不會有此欄位，真正生效的是憑證的 Base URL。n8n 自家的 OpenAI Chat Model 文件 和憑證頁面都沒有說明這個欄位；原始碼則有說明，描述為「覆寫 API 的預設 Base URL」。HTTP Request 節點是完全不同的做法——它可以運作，但你得手動建構原本由 AI Agent 節點代為建構的請求。

啟用或停用 Responses API

• 啟用（節點 1.3 的預設值）— 請求會傳送至 /v1/responses。只有此模式會顯示節點的 內建工具 — Web Search、File Search 和 Code Interpreter。這些工具由 OpenAI 託管；尚無人測試過它們能否透過 Kunavo 使用，因此在實際試用前，不要建立依賴這些工具的工作流程。
• 停用 — 請求會傳送至 /v1/chat/completions，這是支援最廣泛的格式；若另一種模式下的工具呼叫異常，請改用此模式。
• 你附加至 AI Agent 的工具會以函式定義的形式傳送給模型。本次檢查未涵蓋這個往返流程，因此在依賴它之前，請先在測試工作流程中執行一次工具呼叫。

n8n 與 OpenRouter

n8n 提供獨立的 OpenRouter Chat Model 節點，並使用自己的 OpenRouter 認證。該認證有 API Key 欄位，以及隱藏且固定為 https://openrouter.ai/api/v1 的基礎 URL；其測試會呼叫 OpenRouter 自己的 /key 路徑 — 因此 OpenRouter 節點只能連線至 OpenRouter。若你要使用 OpenRouter，請搭配 OpenRouter 金鑰使用該節點；本頁內容都不需要。

包括 Kunavo 在內的其他任何相容於 OpenAI 的端點，都要如上所述透過 OpenAI Chat Model，以及 OpenAI 認證中的基礎 URL 連線。請根據實際差異來選擇 — 需要哪些模型、希望如何付費，以及是否想讓 n8n 和其他工具共用一個餘額 — 而不是依據節點選擇。Kunavo 在這項比較中的資訊請見 Kunavo 與 OpenRouter 的比較。

限制無人值守工作流程的費用

• 節點的 Max Retries 預設為 2，Timeout 預設為 60000 ms。請求逾時後會重試，而每次重試都會產生一筆新的計費請求。
• 在逐項執行的節點上設定 Maximum Number of Tokens — 例如迴圈處理 1,000 列資料時，單次呼叫的費用會乘上相應倍數。
• 每個正式環境工作流程使用不同的 Kunavo 金鑰，這樣用量頁面就能顯示各自的支出；若要撤銷某個金鑰，也不會影響其他金鑰。

錯誤訊息的樣子

• 「401 缺少或無效的 API 金鑰」——Base URL 正確，但金鑰錯誤。已在 2.41.4 重現。
• 「404 <!DOCTYPE html>…」，LangChain 將此問題歸類為 MODEL_NOT_FOUND——這具有誤導性：模型沒有問題，Base URL 缺少 /v1，請求落到了網站。已在 2.41.4 重現。
• JSON 格式的模型無法使用訊息 — 模型 ID 與 GET /v1/models 列出的內容不完全相符。