在 N8N大学，我们见过太多新手被复杂的 API 文档劝退。很多人以为 AI 自动化是大厂的专利，其实只要掌握了正确的配置方法，一个简单的 n8n 流程就能让你拥有 24 小时不打烊的 AI 助手。
今天，笔者就带你从零开始，手把手教你如何在 n8n 中集成 OpenAI API。这不是枯燥的文档搬运，而是基于实战经验的硬核配置指南。
场景导入：为什么你需要 n8n + OpenAI？
想象一下，你每天需要处理大量的客户邮件，或者批量生成产品描述。手动操作不仅耗时，还容易出错。而通过 n8n 的 AI 节点调用 OpenAI，你可以实现：
- 自动化客服：自动读取邮件内容，调用 GPT 生成回复草稿。
- 内容批量生产：输入关键词，自动生成社交媒体文案或文章大纲。
- 数据智能分类：利用 AI 分析非结构化文本，自动打标签。
这种工作流的收益是立竿见影的，它将你从重复劳动中解放出来，专注于更有价值的决策。
准备工作：配置前的“弹药”
在开始搭建流程之前，请确保你手头有以下两样东西：
- n8n 实例：可以是官方云版本，也可以是本地部署（Docker 推荐）。
- OpenAI API Key：这是调用模型的凭证。
如何获取 API Key： 登录 OpenAI 官网，进入 API Keys 页面，点击 Create new secret key。注意，生成后立即复制并保存，因为离开页面后将无法再次查看完整密钥。
核心实操：3步搭建你的第一个 AI 节点
进入 n8n 工作流编辑器，我们开始正式配置。整个流程非常直观，只需关注以下核心步骤。
第一步：添加 AI 节点
在画布空白处点击，搜索并添加 OpenAI 节点（在旧版本中可能显示为 n8n-nodes-langchain，但在最新版中已统一归类）。点击节点进入配置界面。
你会看到一个 Authentication 区域。这里需要设置你的凭证（Credentials）。
第二步：配置 API 凭证 (Credentials)
这是最关键的一步。点击 Create New，选择 OpenAI API。
- API Key：粘贴你刚才获取的密钥。
- Base URL：如果你使用的是官方 API，保持默认即可；如果使用中转服务，请修改此处。
- Organization ID（可选）：如果你有多个组织，填入对应的 ID。
保存凭证后，n8n 会自动测试连接。如果显示绿色的“连接成功”，说明密钥有效。
第三步：设置模型与提示词 (Prompts)
回到节点配置主界面：
- Operation：选择
Chat（对话）或Text Generation（文本生成）。通常我们选Chat。 - Model：下拉选择模型，例如
gpt-4o或gpt-3.5-turbo。 - System Message：这是给 AI 的“人设”。例如：“你是一个专业的客服助理，回复语气要礼貌且简洁。”
- User Message：这是实际要发送的内容。你可以直接输入文字，也可以使用
Expression（表达式）引用上游节点的数据。
配置完成后，点击 Test node。如果一切顺利，你将在 Output 中看到 AI 的生成结果。
避坑指南：实战中容易踩的坑
虽然配置过程简单，但实战中常有“暗礁”。以下是两个 N8N大学 经常遇到的问题：
1. 模型响应超时 (Timeout)
如果你的提示词很长，或者模型负载高，n8n 默认的超时时间可能导致请求失败。
解决方案：在 OpenAI 节点的 Additional Fields 中，找到 Timeout 选项。默认通常是 30000ms（30秒），建议根据实际情况调大到 60000ms。
2. 令牌 (Token) 消耗过快
很多人在调试时无节制地测试，导致 API 费用飙升。尤其是 System Message 写得非常长时，每次请求都会重复消耗这些 Token。
解决方案：调试阶段，先使用轻量级模型（如 gpt-3.5-turbo），并将 System Message 精简到极致。确认流程跑通后，再切换到更强大的模型。
进阶：让数据流动起来
单一的 AI 节点只是起点。真正的威力在于将 AI 节点嵌入到工作流中。
例如，你可以连接一个 Google Sheets 节点读取数据，经过 Set 节点整理格式后，喂给 OpenAI 节点，最后通过 Slack 或 Email 节点发送结果。
在 n8n 中，数据的传递是通过 JSON 对象进行的。理解了这一点，你就能打通任何系统与 AI 之间的壁垒。
FAQ 问答
Q1: 我的 n8n 节点里找不到 OpenAI 选项怎么办？
A: 请确保你的 n8n 版本是最新的。如果使用的是社区版，可能需要手动更新。在节点搜索框输入 "OpenAI" 确保没有拼写错误。
Q2: 使用 OpenAI 节点收费吗？
A: n8n 本身不收费（除非你用的是付费云服务），但 OpenAI 会根据你的 Token 使用量收费。你需要在 OpenAI 官网绑定信用卡。
Q3: 如何处理敏感数据？
A: 尽量不要在 System Message 或输入数据中包含密码、私钥等信息。如果必须处理，建议使用 n8n 的加密环境变量功能。
总结与资源
通过以上步骤，你已经成功在 n8n 中配置了 OpenAI API。从获取密钥、建立凭证到配置节点，每一步都是为了让你能够快速落地应用。记住，工具只是手段，核心在于你的业务逻辑设计。
如果你想深入学习更多 AI 节点的高级用法（如函数调用、RAG 检索增强生成），欢迎持续关注 N8N大学 (n8ndx.com)，这里有更多的实战案例等你探索。
