在 Dify 里把 RelayRouter 添加为自定义模型供应商

在 Dify 里添加 RelayRouter,只需在模型供应商设置中选择 OpenAI 兼容接入方式,将 base_url 指向 https://relayrouter.io/v1,填入你在 https://relayrouter.io/dashboard 创建的 API Key,并调用端点 POST /v1/chat/completions。RelayRouter 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)两种协议,因此保留现有配置即可完成接入,可用模型详情见 https://relayrouter.io/models。

为什么可以直接接入 Dify

因为 RelayRouter 采用与 OpenAI 一致的接口协议,Dify 的 OpenAI 兼容供应商无需额外改造即可对接。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」,这意味着 Dify 现有的 OpenAI 调用逻辑可以直接复用。你只需把 Dify 中原本指向官方地址的 base_url 改为 https://relayrouter.io/v1,再替换 API Key。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。这一点同样适用于 Dify 的配置项,减少了迁移工作量,认证方式为 Authorization: Bearer YOUR_API_KEY。

在 Dify 中配置的具体步骤

配置分为四步,可在 Dify 的模型供应商管理页面完成。以下按顺序操作即可:

1. 登录 https://relayrouter.io/dashboard,创建一个 API Key。
2. 在 Dify 进入设置,添加 OpenAI-API-compatible 类型的模型供应商。
3. 将 API Base URL 填写为 https://relayrouter.io/v1,API Key 填入上一步的密钥。
4. 填写模型名称(例如 gpt-5.5、gemini-3.5-flash 或 Claude 系模型),保存后即可在应用中调用。

保存配置后,Dify 会通过 POST /v1/chat/completions 端点发起请求,并支持流式返回(streaming)。

可选择的模型范围

在 Dify 中可以配置 RelayRouter 支持的多家厂商模型。模型范围涵盖 Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot 等。下表列出常见配置项对照,便于在 Dify 中填写:

各模型的实时费率见 https://relayrouter.io/models。主流模型分组平均较官方标价低约 30 percent,且无平台费。

计费与调试注意事项

在 Dify 调试阶段,请求失败通常不产生费用。RelayRouter 的规则是:失败或报错的请求通常不计费,这在 Dify 中反复测试模型配置时有参考意义。支付方式为 Stripe 银行卡。如果调用返回错误,可先核对 base_url 是否为 https://relayrouter.io/v1、API Key 是否正确、模型名称是否属于支持的模型范围(Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot)。更多接入细节可参考 https://relayrouter.io/docs。

FAQ

问:Dify 里 base_url 应该填什么?

答:填写 https://relayrouter.io/v1,并使用 OpenAI-API-compatible 供应商类型,端点为 POST /v1/chat/completions。

问:调试时失败的请求会扣费吗?

答:失败或报错的请求通常不计费。

问:Dify 里能配置哪些模型?

答:可配置 Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot,实时费率见 https://relayrouter.io/models。