> ## 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.

# Dify

> Dify 平台集成 MixRoute 指南

## 一、产品简介

Dify 是「可视化 + 插件化」的 AI 应用搭建平台，零代码基础也能轻松用大模型，快速搭建专属 AI 工具（比如对话机器人、文本处理工具等）。

通过集成 **MixRoute API**，您可以在 Dify 中使用成本更低的大模型服务，使用效果却几乎无差。

## 二、集成步骤

### 第一步：准备 API 账号

先注册一个 [MixRoute ](https://api.mixroute.ai/)账号，步驟可參考[快速开始](/cn/quickstart)：

### 第二步：进入 Dify 模型供应商设置

1. 打开 Dify 平台，登录后找到「设置」页面
2. 左侧菜单中选中「模型供应商」，进入插件安装界面

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-1-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=c5368ca1fc77dd026ab1307a5b988f35" alt="Dify 设置页面" width="1080" height="530" data-path="images/integrations/dify-1-cn.jpeg" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-2-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=2c60d71f9dc8f28587a98114359d79cd" alt="模型供应商设置" width="1080" height="509" data-path="images/integrations/dify-2-cn.jpeg" />
</Frame>

### 第三步：安装兼容插件

1. 下滑页面，找到「OpenAI-API-compatible」插件
2. 这款插件支持对话、文本嵌入、语音转文字等多种功能，能让 Dify 无缝对接第三方大模型
3. 点击「安装」即可

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-3-cn.png?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=d71ab882a5c484accc390a3333203449" alt="找到兼容插件" width="3578" height="1980" data-path="images/integrations/dify-3-cn.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-4-cn.png?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=aaef0f64533a125d04a0a811bb0a8d71" alt="安装插件" width="3576" height="1684" data-path="images/integrations/dify-4-cn.png" />
</Frame>

### 第四步：配置关键参数（重点！）

安装完成后，点击「增加模型」，需要配置 3 个核心参数：

#### 1. 获取 API Key

* 打开 [MixRoute 控制台](https://api.mixroute.ai/)，进入「API 密钥」页面
* 复制页面生成的密钥，粘贴到 Dify 参数的「API Key」字段

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-5-cn.png?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=f8b8a0be84504441df923a38a21b65c2" alt="获取 API Key" width="3560" height="796" data-path="images/integrations/dify-5-cn.png" />
</Frame>

#### 2. 获取模型名称

* 在控制台的「模型中心」页面，选你需要的模型（比如 Gemini、GPT 系列）
* 点击复制模型名称
* 把复制的名称，分别填入 Dify 的「模型名称」和「API endpoint 中的模型名称」

<Warning>
  两个字段要填写一致！
</Warning>

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-6-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=82cc25f07d8338e29f3c1197cf762bc7" alt="模型名称配置" width="1080" height="526" data-path="images/integrations/dify-6-cn.jpeg" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-7-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=0c41625ac268b4aeec224d9973fcb425" alt="填写模型名称" width="1080" height="633" data-path="images/integrations/dify-7-cn.jpeg" />
</Frame>

#### 3. 填写 API 地址

在 Dify 的「API endpoint」字段中填入：

```text theme={null}
https://api.mixroute.ai/v1
```

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-8-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=9f28de2a779c5b04a253c63ce91e2c9b" alt="填写 API 地址" width="859" height="457" data-path="images/integrations/dify-8-cn.jpeg" />
</Frame>

#### 4. 保存配置

所有参数填完，点击「保存」—— 搞定！第三方模型成功接入 Dify～

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-9-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=ecf66de0f66a938a45362238f6b053b3" alt="保存配置" width="641" height="825" data-path="images/integrations/dify-9-cn.jpeg" />
</Frame>

## 三、配置汇总

| 配置项          | 值                              |
| ------------ | ------------------------------ |
| API Key      | 从 MixRoute 控制台获取               |
| 模型名称         | 如 `gpt-5.5`、`gemini-3.5-flash` |
| API endpoint | `https://api.mixroute.ai/v1`   |

## 四、测试效果

### 测试步骤

1. 打开你在 Dify 创建的工作流任务
2. 把原有模型替换成刚接入的第三方模型
3. 点击「开始运行」，等待执行结果

按照步骤操作，几分钟就能搞定低成本大模型接入！

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-10-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=efe7d07386a3509447bb92d9c8906d07" alt="测试工作流" width="643" height="832" data-path="images/integrations/dify-10-cn.jpeg" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-11-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=1c72f422d17eac286ae1eb75f72f20d1" alt="执行结果" width="1080" height="668" data-path="images/integrations/dify-11-cn.jpeg" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/personal-a5418d9f/FONY9Ku9mRTX58KD/images/integrations/dify-12-cn.jpeg?fit=max&auto=format&n=FONY9Ku9mRTX58KD&q=85&s=7ebd46fe6c999e6e50d3bc452ce9ce1c" alt="成本对比" width="475" height="707" data-path="images/integrations/dify-12-cn.jpeg" />
</Frame>

## 五、优势总结

<CardGroup cols={2}>
  <Card title="成本优势" icon="coins">
    价格更有竞争力
  </Card>

  <Card title="性能稳定" icon="gauge">
    响应速度和官方无差
  </Card>

  <Card title="易于集成" icon="plug">
    通过 OpenAI-API-compatible 插件轻松接入
  </Card>

  <Card title="功能完整" icon="check">
    支持对话、文本嵌入、语音转文字等
  </Card>
</CardGroup>

## 六、注意事项

<Tip>
  * 确保「模型名称」和「API endpoint 中的模型名称」两个字段保持一致
  * API 地址统一使用：`https://api.mixroute.ai/v1`
  * 建议先在测试环境验证配置，确认无误后再用于生产环境
</Tip>