跳到正文
土土金API

整合指南

在 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 步:建立憑據

  1. 進入 Credentials,新建一個 OpenAI 類型的憑據。
  2. 按下表填寫後儲存:
欄位填寫
API Key土土金 API Key
Organization ID留空
Base URLhttps://www.tutujin.com/v1

儲存時 n8n 會用這個憑據請求一次模型列表,能儲存成功說明地址和 Key 都正確。

第 2 步:在工作流裡使用

AI 類工作流(AI Agent、Basic LLM Chain 等)裡,給它掛一個 OpenAI Chat Model 子節點:

  1. Credential 選上一步建立的憑據。
  2. Model 從下拉式清單裡選,列表來自這把 Key 能用的模型;也可以切換到按 ID 填寫,輸入模型名,例如 deepseek-v4.1-flash。
  3. 其餘參數(溫度、最大 tokens 等)按需設定。

需要向量化文本時(比如往向量庫寫入文件),用 Embeddings OpenAI 節點,選同一個憑據,模型填向量模型名,例如 text-embedding-3-small。

用 HTTP Request 節點直接呼叫

不想用 AI 節點,或者要呼叫 AI 節點沒覆蓋的介面時,用 HTTP Request 節點:

欄位填寫
MethodPOST
URLhttps://www.tutujin.com/v1/chat/completions
AuthenticationGeneric Credential Type → Header Auth,Name 填 Authorization,Value 填 Bearer sk-你的Key
BodyJSON,內容見下方
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 填寫後測試
401Key 填錯或已失效
429迴圈裡請求太密集,加等待節點或減小批次

沒找到答案?加客服微信 JsnonoChat,傳送報錯資訊裡的 request id,我們幫你排查。