N8N 工作流使用API中转平台文档教程

# n8n 工作流使用中转 API 教程

> 适用平台：n8n（云端版 / 自建版均可）  
> 中转平台地址：`https://api.zaimod.com`　Base URL：`https://api.zaimod.com/v1`  
> 实现目标：在工作流里调用 `Message a model` 动作，把默认的 OpenAI 官方地址换成中转地址

---

## 一、准备工作

| 项目       | 说明                                                                   |
| -------- | -------------------------------------------------------------------- |
| n8n 环境   | 已能正常登录 n8n 并新建工作流                                                    |
| API Key  | 登录 `https://api.zaimod.com` → **控制台 → API令牌** → 添加令牌，复制 `sk-` 开头的 Key |
| Base URL | `https://api.zaimod.com/v1`                                           |

> Base URL 的写法和官方一致：**只到 `/v1` 为止**，后面不要带 `/chat/completions`，路径由节点自己拼接。

---

## 二、操作步骤

### 步骤 1：创建一个新的工作流

在 n8n 首页点击右上角 **Create Workflow**。

![](/uploads/editor/20261031/img_6ae5eb8cccb369.31966891.png)

---

### 步骤 2：选择触发方式

点击画布中央的 **Add first step...**，右侧弹出「What triggers this workflow?」面板，选择第一个 **Trigger manually**（手动触发，用于测试）。

![](/uploads/editor/20261031/img_6ae5eb97117228.87946487.png)

---

### 步骤 3：添加下一个节点

点击 **When clicking 'Execute workflow'** 节点右侧的 **+**，弹出「What happens next?」面板。

![](/uploads/editor/20261031/img_6ae5eba2251233.50348971.png)

---

### 步骤 4：选择 AI 分类

在面板中点选 **AI** 分类，进入 AI Nodes 列表。

![](/uploads/editor/20261031/img_6ae5ebabec90c7.88574160.png)

---

### 步骤 5：选择 OpenAI，并选对动作

1. 在 AI Nodes 列表中选择 **OpenAI**。
2. 进入 OpenAI 动作列表后，展开 **TEXT ACTIONS** 分组，选择 **Message a model**。

> **聊天场景必须选 `Message a model`**。列表里还有 `Create an assistant`、`List assistants` 等动作，选错的话不会返回对话内容。

![](/uploads/editor/20261031/img_6ae5ebbae8f8c3.95149730.png)

---

### 步骤 6：新建凭据并填入中转地址

1. 节点面板中 **Credential to connect with** 下拉框里选择 **Create new credential**（首次使用时下拉框为空，需先新建）。

![](/uploads/editor/20261031/img_6ae5ebc36ee0e6.27643570.png)

1. 弹出「OpenAI account」凭据窗口，按下面三栏填写：

| 字段                             | 填写内容                              |
| ------------------------------ | --------------------------------- |
| **API Key**                    | 你的 Key，`sk-` 开头，直接粘贴（不加 `Bearer`） |
| **Organization ID (optional)** | 留空                                |
| **Base URL**                   | `https://api.zaimod.com/v1`        |

> **Base URL 这一栏在弹窗底部，需要往下滚动才能看到**，很多人卡在这里以为没有这个字段。它的默认值是 `https://api.openai.com/v1`，直接把域名部分换成中转地址即可。

1. 点击右上角 **Save** 保存。

---

### 步骤 7：确认连接成功

保存后，凭据窗口顶部出现绿色提示 **Connection tested successfully**，说明 Key 与 Base URL 都正确、已能连通中转站。

![](/uploads/editor/20261031/img_6ae5ebd674fa90.39108500.png)

> 若这里报错，先别继续往下配置：`401` 多为 Key 问题，`404` 多为 Base URL 写错（漏 `/v1` 或多了路径）。点右侧 **Retry** 可重试。

---

### 步骤 8：配置节点参数

回到节点面板，按下表填写（`Parameters` 标签页）：

| 参数                             | 填写内容                            |
| ------------------------------ | ------------------------------- |
| **Credential to connect with** | 选择刚创建的凭据（如 `OpenAI account`）    |
| **Resource**                   | `Text`                          |
| **Operation**                  | `Message a Model`               |
| **Model**                      | 选 `By ID`，然后填模型名，如 `gpt-4o`     |
| **Messages → Prompt / Role**   | 第一条设为 System（人设），第二条设为 User（提问） |
| **Simplify Output**            | 保持开启，输出更干净                      |
| **Output Content as JSON**     | 按需开启；开启后返回结构为 JSON              |

关于模型名：建议用 **By ID** 直接手填（如 `gpt-4o`）。用 `From list` 需要凭据先验证通过才能拉到列表，列表拉不到时反而看不出问题在哪。

多条消息用 **Add Message** 继续添加，例如：

- 第 1 条：Role = `System`，Prompt = `你是一个助手，名字叫小可`
- 第 2 条：Role = `User`，Prompt = `你是谁`

![](/uploads/editor/20261031/img_6ae5ebeb556b94.59772130.png)

其余选项（Simplify Output、Output Content as JSON、Add Option）保持默认即可：

![](/uploads/editor/20261031/img_6ae5ebf35490f9.71536581.png)

---

### 步骤 9：运行测试

点击节点面板右上角的 **Execute step** 运行。右侧 **OUTPUT** 面板出现 `message.content` 且有模型回复内容，即为调用成功。

![](/uploads/editor/20261031/img_6ae5ebffe004e0.01663005.png)

---

## 三、配置速查表

**凭据（OpenAI account）**

| 字段              | 值                          |
| --------------- | -------------------------- |
| API Key         | `sk-你的Key`                 |
| Organization ID | 留空                         |
| Base URL        | `https://api.zaimod.com/v1` |

**节点参数（Message a model）**

| 参数              | 值                          |
| --------------- | -------------------------- |
| Resource        | `Text`                     |
| Operation       | `Message a Model`          |
| Model           | `By ID` → `gpt-4o`         |
| Messages        | System 一条（人设）+ User 一条（提问） |
| Simplify Output | 开启                         |

---

## 四、几个关键点

- **Base URL 只到 `/v1`**：写成 `https://api.zaimod.com/v1/chat/completions` 会 404，节点会自己拼接路径。
- **Base URL 字段在凭据弹窗最下方**：默认值是官方地址，需要滚动到底部替换。
- **动作必须选 Message a model**：这是唯一会返回对话内容的动作。
- **模型名用 By ID 手填**：避免列表拉取失败导致误判。
- **切换其他中转站或更换 Key 时**：改凭据里的 Base URL / API Key 即可，节点参数不用动。

---

## 五、常见问题

| 现象                          | 原因与处理                                                 |
| --------------------------- | ----------------------------------------------------- |
| 凭据弹窗里找不到 Base URL           | 字段在弹窗底部，向下滚动；自建版版本较老时可能叫 `Base URL` 且需展开 Advanced 选项  |
| 保存时提示 `401` / Invalid token | Key 错误、含空格，或令牌已过期；重新在控制台创建令牌                          |
| 保存时提示 `404`                 | Base URL 写错：漏了 `/v1`，或误加了 `/chat/completions`         |
| 连接成功但执行报模型不存在               | `Model` 名称与平台可用列表不一致，换用平台支持的模型名                       |
| OUTPUT 里没有对话内容              | 动作选成了其他动作（如 Create an assistant），改回 `Message a model` |
| 输出结构复杂、不好取字段                | 打开 `Simplify Output`，或在后续节点用表达式取 `message.content`    |
| 想换成别的模型                     | 改节点里的 `Model` 即可，无需动凭据                                |
| 工作流保存后不执行                   | 手动触发需要点 `Execute workflow`，右上角 `Inactive` 开关只影响自动触发   |

---

## 附录 A：接口地址变更对照

| 位置               | 原地址                         | 现地址                        |
| ---------------- | --------------------------- | -------------------------- |
| 凭据中的 `Base URL`  | `https://api.zaimod.com/v1` | `https://api.zaimod.com/v1` |
| 参考（OpenAI 官方默认值） | `https://api.zaimod.com/v1` | `https://api.zaimod.com/v1` |

> Key 请在 `https://api.zaimod.com` 重新创建后填入凭据；已存在的工作流只需改凭据，节点参数无需调整。

## 附录 B：本次整理修正的原文问题

| 原文问题                                                                                 | 处理方式                                                  |
| ------------------------------------------------------------------------------------ | ----------------------------------------------------- |
| 步骤文字极简（如「4.选择 openai」「8.我简单的配置一下这个模块」），不看图无法操作                                       | 每步补齐具体点击位置与填写内容                                       |
| Base URL 表述含糊：「填写 我们中转地址 `https://api.openai.com/v1` 改成 `https://api.zaimod.com/v1`」 | 改写为「凭据中的 Base URL 默认是官方地址，把域名替换为中转地址」，并说明字段位置在弹窗底部需滚动 |
| 未说明 API Key 的获取路径                                                                    | 补充「控制台 → API令牌 → 添加令牌」                                |
| 未说明节点参数（Resource / Operation / Model / Messages）如何填写                                 | 新增步骤 8 的参数表与示例消息                                      |
| 「完美响应」没有判据                                                                           | 明确成功判据：OUTPUT 中出现 `message.content` 且有回复内容            |
| 缺少错误排查                                                                               | 新增常见问题表，区分 401 / 404 / 模型不存在等场景                       |
| 未说明 `Message a model` 为什么必须选                                                         | 补充说明（其余动作为助手管理类，不返回对话内容）                              |
| 截图顺序与文字顺序略有出入（配置截图在前、成功截图在后）                                                         | 按实际操作顺序重排，并把成功提示图放到「确认连接」这一步                          |

上一篇：OpenClaw 最自定义中转站配置教程{else}上一篇：没有了下一篇：Gemini CLI 中转站配置教程{else}下一篇：没有了