跳到正文
土土金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,我们帮你排查。