> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> n8n 工作流接入 MixRoute API 配置指南

## n8n 介绍

n8n 是一款开源的工作流自动化工具，旨在帮助用户通过连接不同的应用程序和服务来实现任务自动化。它支持低代码/无代码的方式，使用户能够通过拖拽节点来构建复杂的自动化流程，而无需编写大量代码。n8n 的核心功能是提供一个灵活的平台，允许用户自定义和扩展工作流，以满足各种自动化需求。

通过接入 **MixRoute API**，您可以在 n8n 中使用 GPT、Gemini、Claude 等主流大模型，构建智能自动化工作流。

<Info>
  请选择 **OpenAI Account** 凭证进行配置，GPT、Gemini、Claude 等模型均在 OpenAI 账户里进行设置。
</Info>

## 接入前准备

<CardGroup cols={1}>
  <Card title="准备信息" icon="list-check">
    * 一个可用的 MixRoute API Key（在 [控制台](https://api.mixroute.ai/) 创建）
    * MixRoute API 地址：`https://api.mixroute.ai/v1`
  </Card>
</CardGroup>

## 配置步骤

### 第一步：创建或编辑 OpenAI 凭证

1. 在 n8n 中点击右上角 **设置**（齿轮图标）或进入工作流编辑页面
2. 选择 **Credentials**（凭证）→ 点击 **Add Credential**（添加凭证）
3. 搜索并选择 **OpenAI**
4. 若已有 OpenAI 凭证，也可直接编辑

### 第二步：填写 MixRoute API 参数

在 OpenAI 凭证配置界面中填写：

| 参数               | 填写内容                                                        |
| ---------------- | ----------------------------------------------------------- |
| **API Key**      | 在 [MixRoute 控制台](https://api.mixroute.ai/) 的「API 密钥」页面复制的密钥 |
| **Base URL**（如有） | `https://api.mixroute.ai/v1`                                |

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/RGoSkNyCj5D5PW8q/images/integrations/n8n-setup.png?fit=max&auto=format&n=RGoSkNyCj5D5PW8q&q=85&s=ffc1c2e4ca010a489c0fa4fa5c1a8a22" alt="n8n 凭证配置界面" width="1257" height="832" data-path="images/integrations/n8n-setup.png" />
</Frame>

<Warning>
  Base URL 必须包含 `/v1` 后缀。部分 n8n 版本中，Base URL 可能在凭证的「Additional Fields」或「Options」中。
</Warning>

### 第三步：选择模型

1. 在工作流中添加 **OpenAI** 或 **Chat OpenAI** 等 AI 节点
2. 选择刚配置的 MixRoute 凭证
3. 在 **Model** 中选择模型，或输入 MixRoute 支持的模型 ID，例如：
   * `gpt-5.5`
   * `gemini-3.5-flash`
   * `claude-opus-4-8`
   * 更多模型可在 [模型列表](https://console.mixroute.ai/models) 查看

### 第四步：测试工作流

保存工作流后执行测试，若返回正常对话结果，说明接入成功。

## 关键配置说明

* **API Key**：从 MixRoute 控制台获取，不要使用 OpenAI 官方密钥
* **Base URL**：固定为 `https://api.mixroute.ai/v1`
* **模型 ID**：必须与 MixRoute 暴露的模型名称一致，可在 [模型中心](https://console.mixroute.ai/models) 查看

## 常见问题

* **无法连接**：检查 Base URL 是否填写正确，是否包含 `/v1`
* **模型不存在**：确认模型 ID 与 MixRoute 模型中心一致
* **认证失败**：检查 API Key 是否有效、是否已复制完整