Dify 接入

Dify 是开源的 LLM 应用开发平台，通过 OpenAI-API-compatible 模型供应商接入 Router，Dify 里的全部应用即可使用 Router 的模型。

• 协议：OpenAI Chat Completions
• 接入地址：https://routerapi.<你的域名>/v1

准备工作

1. 登录 Router 控制台，签发一个 Key 并保存明文
2. 在控制台「快速接入」页记下 OpenAI Chat Completions 协议的接入地址
3. Dify 管理员账号（配置模型供应商需要管理权限）

配置

1. 登录 Dify → 右上角头像 → 设置 → 模型供应商
2. 找到 OpenAI-API-compatible（未安装则先在插件市场安装该供应商插件），点添加模型
3. 逐项填写：
   • 模型类型：选 LLM
   • 模型名称：控制台「可用模型」列表中的名称（如路由池名）
   • API Endpoint URL：https://routerapi.<你的域名>/v1
   • API Key：你的 Key
   • 其余选项（上下文长度、最大 tokens 等）按模型实际情况填
4. 保存

验证

1. 在 Dify 创建一个空白「聊天助手」应用
2. 右上角模型选择刚添加的模型
3. 在调试面板发一条消息，正常流式回复即接入成功；控制台「调用记录」出现调用明细

常见问题

Q：保存时报「验证失败」？ 检查 Endpoint URL 以 /v1 结尾、Key 完整、Dify 服务端网络可访问数据面域名；模型名称与控制台「可用模型」列表完全一致。

Q：流式响应异常或一直转圈？ 确认 Dify 到数据面域名之间没有经过会缓冲 SSE 的反向代理（如未关缓冲的 nginx）。Router 数据面本身逐块推送不缓冲。

Q：想在 Dify 里用多个模型？ 在同一个供应商下多次「添加模型」即可，每个模型一条。