n8n 串接教學

開源的自動化工作流程平台，改一下 OpenAI 憑證的 Base URL 就能用櫻桃茶模型

串接步驟

新增 OpenAI 憑證
左側進入「Credentials」→「Create credential」（或在節點中點「Create new credential」），搜尋並選擇「OpenAI」，填寫下列各項，Organization ID 留空，點「Save」。n8n 會用這個網址測試連線。
- API Key：sk-你的金鑰
- Base URL：https://gpt.cherrychat.org/v1（把預設的 https://api.openai.com/v1 換成這個）
在 OpenAI Chat Model 節點中使用
在「AI Agent」或「Basic LLM Chain」節點下掛一個「OpenAI Chat Model」子節點：Credential 選剛建立的憑證；Model 從清單選，清單載入不出來就切到「By ID」手動填寫；「Use Responses API」保持關閉。
- Model（By ID）：gpt-6.1-sol
執行測試
點節點上的「Execute step」或執行整個工作流程，看到模型的回覆就接通了。
不用 AI 節點時：HTTP Request
也可以直接用「HTTP Request」節點：Method 選 POST，URL 填 https://gpt.cherrychat.org/v1/chat/completions，Authentication 用「Generic Credential Type」→「Header Auth」（Name 填 Authorization，Value 填 Bearer 加空格再加 key），打開「Send Body」，Body Content Type 選 JSON，貼上下方內容。
```
{
  "model": "gpt-6.1-sol",
  "messages": [{ "role": "user", "content": "你好" }]
}
```

Base URL 寫到 /v1（https://gpt.cherrychat.org/v1）；儲存憑證時 n8n 會請求 https://gpt.cherrychat.org/v1/models 做測試。
「Use Responses API」保持關閉：打開後會帶上 Web Search 等內建工具，櫻桃茶 API 暫不支援。
n8n Cloud 上 Credential 不要選「Use Gateway credits」，那是 n8n 自己的額度，不會用到櫻桃茶。
HTTP Request 節點裡不要把 key 直接寫進 Header 參數，用 Header Auth 憑證保存，匯出工作流程時才不會把 key 帶出去。

看到的錯誤	原因	怎麼辦
儲存憑證時提示 Couldn't connect / 401	API Key 複製錯了、帶了空格，或這把 key 已停用	到 API 頁「我的金鑰」重新複製後再儲存
出現 404 Not Found	Base URL 少了 /v1，或 HTTP Request 的 URL 沒寫全	憑證填 https://gpt.cherrychat.org/v1；HTTP Request 填 https://gpt.cherrychat.org/v1/chat/completions
模型清單載入不出來或提示模型不存在	清單載入失敗，或手動填的模型名稱寫錯	Model 切到「By ID」，依模型價格頁填 gpt-6.1-sol
出現 402 或「餘額不足」（Claude 格式顯示 billing_error）	帳戶點數不足以支付這次呼叫。API 呼叫只扣點數，會員卡與無限卡都不抵扣	到櫻桃茶·智域GPT 的「商店」儲值任意金額，幾秒後重試即可
出現 429 Too Many Requests	請求太快：預設每把 key 每分鐘最多 120 次，每個帳號同時最多 8 個請求	調低工具裡的並行數或每秒請求數，依提示的 Retry-After 秒數稍等再試；多數工具會自動重試

教學核對於 2026-11-02。工具介面改版後可能和這裡略有不同，以官方文件為準。

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 內容由 AI 生成，請仔細甄別