集成指南
在 n8n 中使用
在 n8n 的 OpenAI 凭据里填土土金 API Key,并把 Base URL 改成 https://open.tutujin.com/v1,就能在 AI Agent、对话模型和向量节点里调用 GPT、Claude、DeepSeek 等模型;也可以用 HTTP Request 节点直接调用。
n8n 接入土土金 API 的做法是改 OpenAI 凭据:API Key 填土土金的 Key,Base URL 从默认的 OpenAI 地址改成 https://open.tutujin.com/v1。之后所有使用这个凭据的 OpenAI 相关节点都会请求土土金 API,模型名填模型广场里的名称即可。
下面按较新版本的 n8n 界面描述,不同版本的节点名称和字段位置可能略有不同。
第 1 步:创建凭据
- 进入 Credentials,新建一个 OpenAI 类型的凭据。
- 按下表填写后保存:
| 字段 | 填写 |
|---|---|
| API Key | 土土金 API Key |
| Organization ID | 留空 |
| Base URL | https://open.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://open.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://open.tutujin.com/v1,Key 是否完整 |
| 模型下拉列表里没有想要的模型 | 这把 Key 所在分组没有该模型,换分组的 Key,或改为按 ID 填写后测试 |
| 401 | Key 填错或已失效 |
| 429 | 循环里请求太密集,加等待节点或减小批次 |
没找到答案?加客服微信 JsnonoChat,发送报错信息里的 request id,我们帮你排查。