# 给所有 Dify 应用一个统一的模型供应商

> https://router.one/zh/integrations/dify 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-09-05

Dify 是目前使用最广的 LLM 应用与 Agent 工作流平台之一。每个上线的应用背后都要接一个模型供应商——如果每个系列都单独开号，就意味着多套 Key、多份账单、多种故障模式。把 Router One 以 OpenAI-API-compatible 方式注册一次，一份凭证覆盖整个模型目录，每次应用调用都有成本 Trace。

## 把 Dify 配置到 Router One base URL

在 Dify 中打开 设置 → 模型供应商 → 添加 OpenAI-API-compatible 模型，填入模型 ID、base URL 和 Key：

`dify-model-provider`

```text
# Dify → Settings → Model Provider → OpenAI-API-compatible
Model Name:    <model-id-from-/models>
API endpoint:  https://api.router.one/v1
API Key:       sk-your-router-one-key
```

## Dify 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Dify 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个工具单独建 API Key，并设置 maxSpend 消费上限。

## Dify 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

## 在 trace 里验证 Dify 的调用

先在 Dify 发出一次简单文本请求，再到 Dashboard → Logs 按时间、模型和 request_id 核对 trace：tokens、花费、延迟和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

## 常见问题

### 在 Dify 里选哪种供应商类型？

在模型供应商列表里选「OpenAI-API-compatible」。想暴露给应用的每个模型加一条，模型 ID 用 /models 页的精确 ID——添加后即可在 Dify 应用里选用。

### Dify 能通过网关用哪些模型？

选用当前目录中同时支持 Dify 所用端点和所需功能的模型。精确 ID、当前单价与能力以 /models 及模型详情为准；不要仅按 GPT、Claude 等系列名判断兼容性。客户端能列出模型，只证明模型发现成功，仍需验证实际调用。

### 能列出模型，但调用报 400 或 404，怎么办？

先记录实际请求路径和错误消息，再核对精确模型 ID。400 可能是参数、工具类型或模型与端点不匹配；404 可能是请求路径或资源不存在，不能直接判定模型下线。若错误提示 must be called via，按它指明的端点调整客户端 provider，或换用支持当前端点的模型。不要在所有工具里统一增删 /v1 或 /chat/completions。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/402/403/429 怎么排查？

先到 Dashboard → Logs 核对请求及错误消息。401 查 Key 是否传入和有效；402 查钱包余额与 maxSpend；403 查 Key 权限和访问限制；429 查请求频率、token 限额及上游限流，按错误来源处理。保留 request_id，再按错误码速查页逐项排查。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- Dify 的 API 错误排查：https://router.one/zh/llm-api-error-codes
- API 兼容性：端点与功能对照：https://router.one/zh/facts/api-compatibility.md
- Responses API 配置与限制：https://router.one/zh/codex-responses-api
- Roo Code 接入：https://router.one/zh/integrations/roo-code
- OpenCode 接入：https://router.one/zh/integrations/opencode
- n8n 接入：https://router.one/zh/integrations/n8n
- 网关层负责什么：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/dify
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md