当前位置：

文章详情

N8N 保姆级教程：从 API 中转站配置到 AI 工作流跑通

在使用 N8N 搭建 AI 工作流的过程中，OpenAI 节点是非常常见的一个功能节点。很多用户会通过它来调用 OpenAI 接口，或者接入第三方 OpenAI 兼容接口、API 中转服务和各类大模型平台，用于实现文本生成、AI问答、内容处理等自动化任务。

不过，对于刚开始使用 N8N 的用户来说，OpenAI 节点的配置过程并不算简单。尤其是在使用 Message a model 动作时，如果对 API Key、Base URL、模型名称、消息参数等配置项不够了解，就很容易出现接口调用失败、返回报错、模型无法识别等问题。

本文将以 N8N OpenAI 节点配置第三方接口为主题，结合实际步骤，详细讲解 Message a model 的使用方法，以及 API Key、Base URL、模型名称和消息内容的正确填写方式。同时，还会对常见报错问题进行整理和分析，帮助你一步一步完成配置，顺利实现 N8N 调用第三方大模型接口。

一. 创建新的 N8N 工作流

进入 N8N 后，在工作流列表页面单击右上角的 Create Workflow，新建一个空白工作流。创建后会进入编辑画布，可以在这里添加触发器和后续执行节点。

二. 选择触发方式

在新工作流中，先需要设置触发器。N8N 提供多种触发方式，例如：

手动触发 Trigger manually
定时触发 On a schedule
Webhook 触发 On webhook call
表单提交 On form submission
聊天消息 On chat message
由其他工作流触发

本教程选择顶部 Trigger manually，也就是手动触发。这个方式适合初次配置和测试，因为可以直接单击执行按钮查看节点是否能正常运行。

三. 添加下一个工作流模块

触发器添加完成后，单击节点右侧的加号，开始添加下一步模块。右侧面板会出现可选分类，包括 AI、Action in an app、Data transformation、Flow、Core 等。这里选择 AI 分类，用于配置大模型相关能力。

四. 选择 OpenAI 节点

在 AI 节点列表中，可以看到多个模型或 AI 工具选项，例如 AI Agent、Anthropic、Google Gemini、OpenAI、Basic LLM Chain 等。这里选择 OpenAI 节点，用于调用 OpenAI 兼容接口。

进入 OpenAI 节点后，会出现多个动作类型，包括创建助手、消息助手、图像分析、生成图片、音频处理等。用于普通聊天或文本生成时，需要选择 Message a model。

五. 为什么需要 API 中转站？

在 N8N 中调用 AI 模型时，很多用户会直接使用官网 OpenAI API。不过在实际使用过程中，可能会遇到一些常见问题，例如网络访问不稳定、接口连接失败、不同模型服务商的接口格式不统一、多个模型账号管理不方便等。这时，API 中转站就能起到一个统一入口的作用。

API 中转站通常会提供 OpenAI 兼容格式的接口地址，也就是说N8N仍然可以使用 OpenAI 节点进行调用，但实际请求会通过中转站分享到对应的模型服务。这样做的好处主要有：

统一接口格式

很多中转站会兼容 OpenAI API 格式，N8N 中只需要配置 API Key 和 Base URL，就可以像调用 OpenAI 一样调用其他兼容模型。

方便切换不同模型

如果后续需要从 gpt-4o 切换到其他模型，通常只需要修改模型名称或中转站后台配置，不需要大幅调整整个 N8N 工作流。

降低配置复杂度

对于不熟悉 API 请求结构的用户来说，中转站可以减少很多额外配置。尤其是在 N8N 这类可视化工具中，只要节点支持 OpenAI 兼容接口，就能比较快速地完成接入。

提升工作流扩展性

当一个工作流中需要调用多个 AI 模型，或者后续要接入聊天机器人、内容生成、数据分析、自动回复等场景时，使用统一的 API 入口会更便于维护。

因此，在 N8N 中对接 API 中转站的关键点，就是将 OpenAI 节点中的 Base URL 从默认官网地址，修改为中转站提供的兼容接口地址。接下来就进入具体的 API 凭证和 Base URL 配置步骤。

六. 配置 API 凭证和 Base URL

进入 “Message a model” 配置页后，先在 Credential 区域选择或创建新的 OpenAI 账号凭证。API Key 可以在对应的 API 令牌页面生成后填写。

如果使用的是 OpenAI 兼容接口或中转接口，需要注意 Base URL 的填写。默认地址通常是：

https://api.openai.com/v1

在本示例中，将 Base URL 修改为以下：

https://api.allmhub.com/

单击保存

这里的作用是让 N8N 的 OpenAI 节点请求特定的兼容接口地址。填写完成后单击 Save 保存。如果页面提示 Connection tested successfully，说明凭证和接口地址连接成功。

七. 配置 Message a model 参数

连接成功后，回到 OpenAI 节点参数设置页面。基础配置可参考以下方式：

Resource：选择 Text
Operation：选择 Message a Model
Model：可选择 By ID，并填写模型名称，例如 gpt-4o
Messages：添加对话内容
Role：根据消息类型选择 System 或 User

例如，可以先添加一条 System 消息，用于设定模型角色：

你是xxx，你只会嘤嘤嘤

然后再添加一条 User 消息：

你是谁

如果只是测试输出，可以保持 Simplify Output 开启，这样返回内容会更简洁，便于查看结果。

八. 执行节点测试

配置完成后，单击节点右上角的 Execute step 进行单步测试。N8N 会向配置好的接口发送请求，并在右侧 Output 区域展示返回结果。

如果配置无误，可以看到返回数据中包含 message、content、finish_reason 等字段。例如返回内容显示为模型生成的回复，finish_reason 为 stop，说明本次请求已正常结束。

九. 常见问题处理方案

如果测试失败，可以依次检查以下内容：

API Key 是否填写正确；
Base URL 是否为完整地址，并包含 /v1；
模型名称是否填写正确，例如 gpt-4o；
OpenAI 节点动作是否选择了 “Message a model”；
Messages 中是否至少包含一条有效 Prompt；
网络或接口服务是否可访问。

总结

通过以上步骤，可以在 N8N 中完成一个基础的 AI 工作流配置：先创建工作流，再使用手动触发器，随后添加 OpenAI 节点并选择 “Message a model”，以及填写 API Key、Base URL、模型名称和对话内容进行测试。这个流程适合作为 N8N 接入 AI 模型的入门模板，后续可以继续扩展到 Webhook、定时任务、表格处理、内容生成等自动化场景。