> ## 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 是否有效、是否已複製完整