整合指南
在 n8n 中使用
在 n8n 的 OpenAI 憑據裡填土土金 API Key,並把 Base URL 改成 https://www.tutujin.com/v1,就能在 AI Agent、對話模型和向量節點裡呼叫 GPT、Claude、DeepSeek 等模型;也可以用 HTTP Request 節點直接呼叫。
n8n 接入土土金 API 的做法是改 OpenAI 憑據:API Key 填土土金的 Key,Base URL 從預設的 OpenAI 地址改成 https://www.tutujin.com/v1。之後所有使用這個憑據的 OpenAI 相關節點都會請求土土金 API,模型名填模型廣場裡的名稱即可。
下面按較新版本的 n8n 介面描述,不同版本的節點名稱和欄位位置可能略有不同。
第 1 步:建立憑據
- 進入 Credentials,新建一個 OpenAI 類型的憑據。
- 按下表填寫後儲存:
| 欄位 | 填寫 |
|---|---|
| API Key | 土土金 API Key |
| Organization ID | 留空 |
| Base URL | https://www.tutujin.com/v1 |
儲存時 n8n 會用這個憑據請求一次模型列表,能儲存成功說明地址和 Key 都正確。
第 2 步:在工作流裡使用
AI 類工作流(AI Agent、Basic LLM Chain 等)裡,給它掛一個 OpenAI Chat Model 子節點:
- Credential 選上一步建立的憑據。
- Model 從下拉式清單裡選,列表來自這把 Key 能用的模型;也可以切換到按 ID 填寫,輸入模型名,例如
deepseek-v4.1-flash。 - 其餘參數(溫度、最大 tokens 等)按需設定。
需要向量化文本時(比如往向量庫寫入文件),用 Embeddings OpenAI 節點,選同一個憑據,模型填向量模型名,例如 text-embedding-3-small。
用 HTTP Request 節點直接呼叫
不想用 AI 節點,或者要呼叫 AI 節點沒覆蓋的介面時,用 HTTP Request 節點:
| 欄位 | 填寫 |
|---|---|
| Method | POST |
| URL | https://www.tutujin.com/v1/chat/completions |
| Authentication | Generic Credential Type → Header Auth,Name 填 Authorization,Value 填 Bearer sk-你的Key |
| Body | JSON,內容見下方 |
{
"model": "deepseek-v4.1-flash",
"messages": [
{ "role": "system", "content": "把用户的反馈分类为:物流、质量、售后、其他。只输出类别。" },
{ "role": "user", "content": "快递三天了还没到" }
]
}回覆在返回結果的 choices[0].message.content 裡,後續節點可以直接引用。其他介面換 URL 和請求體即可,參數見 API 參考。
控制費用
n8n 的定時和批次工作流容易在短時間內發出大量請求。建議給 n8n 單獨建一把 Key、設定額度上限,並在迴圈節點裡控制批次大小,避免觸發限流,見限流說明。每次呼叫的費用都能在控制台「操作日誌」裡查到。
常見問題
| 現象 | 原因與處理 |
|---|---|
| 儲存憑據失敗 | 檢查 Base URL 是否為 https://www.tutujin.com/v1,Key 是否完整 |
| 模型下拉式清單裡沒有想要的模型 | 這把 Key 所在分組沒有該模型,換分組的 Key,或改為按 ID 填寫後測試 |
| 401 | Key 填錯或已失效 |
| 429 | 迴圈裡請求太密集,加等待節點或減小批次 |
沒找到答案?加客服微信 JsnonoChat,傳送報錯資訊裡的 request id,我們幫你排查。