n8n 接入 AI Gateway 教程：把大模型能力接进自动化工作流

这篇教程适合谁？

如果你正在搜索 n8n 接入 OpenAI 兼容接口、n8n 接 AI Gateway、自动化工作流接大模型，这篇就是给你的。它重点讲怎么接得稳、怎么方便后续换模型，而不是只跑一个 demo。

一、n8n 里最适合接 AI 的场景

表单提交后自动总结用户需求
客户消息自动分类、打标签、分流
工单内容自动提取关键信息
知识内容自动生成摘要、标题和多版本文案
把 CRM、邮箱、IM 消息接成智能工作流

这些场景的共同点是：它们更需要稳定的接口接法和统一令牌管理，而不是一次性的手工调用。

二、为什么建议走 OpenAI 兼容接口

n8n 本身对 OpenAI 风格的生态比较友好。通过兼容接口接入，你能保留现有工作流结构，同时把模型供应层独立出来。未来想换模型、调价格、做故障切换，成本会低很多。

Base URL: https://api.bangban.xin/v1

三、接入前准备

一个可用的 n8n 实例
帮搬办AI Gateway 的 API 令牌
准备调用的模型名
一个真实工作流场景，不要只为了测试而测试

四、建议优先从哪些节点开始

HTTP Request 节点
OpenAI / Chat 类节点（如果支持自定义 base URL）
Webhook + Set + Code + IF 组合节点
数据库 / 表单 / IM 通知节点联动

五、最稳的方式：先用 HTTP Request 直接调

如果你不确定某个 AI 节点对兼容接口支持得够不够完整，最稳的方式通常是直接用 HTTP Request 节点发请求。

POST https://api.bangban.xin/v1/chat/completions
Authorization: Bearer sk-your-token
Content-Type: application/json

请求体可以先从最小版本开始：

{
  "model": "gpt-4o-mini",
  "messages": [
    {"role": "system", "content": "你是自动化工作流助手"},
    {"role": "user", "content": "请把这段客户反馈总结成一句话"}
  ]
}

六、一个典型工作流例子

例如表单咨询自动分流：

Webhook 接收官网表单
Set 节点整理用户字段
HTTP Request 调 AI Gateway 做意图识别
IF 节点按结果分流到销售 / 客服 / 技术
Slack / 飞书 / 邮件节点通知对应负责人

七、提示词怎么写更适合工作流

n8n 工作流里的提示词，最好输出结构明确、字段稳定，方便后续节点处理：

你是一个客户咨询分类助手。
请把输入内容识别为：售前咨询 / 技术支持 / 价格问题 / 投诉反馈。
只输出 JSON：
{"category":"...","reason":"..."}

八、最常见的 5 个报错

1. 401 Unauthorized

通常是令牌错了，或者 Authorization 头没写对。

2. 404 Not Found

通常是 base URL 或路径拼错，尤其是把 /v1 漏掉。

3. JSON 解析失败

说明提示词没把输出格式约束好，或者返回内容不是你预期的结构。

4. 429 Too Many Requests

说明你的工作流并发太高，建议增加重试、队列或限速。

5. 工作流能跑但结果不稳定

这大多是提示词问题，不一定是接口问题。先把输入、输出结构收紧。

九、上线前建议

不同工作流使用不同令牌，便于统计和限流
高价值流程加重试与失败告警
尽量要求模型输出 JSON 或固定字段
先在低风险流程试运行，再扩到核心流程
把模型调用与业务分支逻辑分开，便于后期切换模型

十、为什么这篇适合做 SEO 长尾页

搜“n8n 接 AI Gateway”或“n8n 接 OpenAI 兼容接口”的人，基本都已经准备实操了。这类关键词不是泛流量，而是很靠近落地和转化的需求，特别适合放进教程集群里。