如何在Dify中利用ModelScope（魔搭社区）的模型API

要在Dify中直接调用ModelScope（魔搭社区）托管的开源大模型，比如DeepSeek-R1或Qwen2.5-VL，必须通过OpenAI-API-compatible插件桥接——因为Dify原生不支持魔搭自定义协议，而魔搭恰好提供了OpenAI兼容的推理接口，这是唯一可行的接入路径。

直接说答案：流程分四步——注册获取Token、安装插件、配置参数、测试调用。下面一步步拆解，保证你五分钟内跑通。

注册并获取魔搭API密钥

访问ModelScope官网，使用手机号或邮箱完成注册并登录。进入「我的AccessToken」页面，点击「创建新的Token」，复制生成的SDK Token。这个Token就是后续在Dify中填写的API Key，

。

注意：免费额度为每日2000次调用，注册即生效，无需绑定支付方式。

安装OpenAI-API-compatible插件

登录Dify控制台，左侧导航栏点击「设置」→「模型供应商」，在搜索框输入“openai compatible”，找到最新插件「OpenAI-API-compatible」，点击「安装」。安装完成后，该插件会出现在已启用的模型供应商列表中，无需重启服务。

配置魔搭模型参数

在「模型供应商」列表中，点击刚安装的「OpenAI-API-compatible」插件右侧的「配置」按钮。按以下三项填写，缺一不可：

① API Endpoint URL：

。填错会导致请求路径重复拼接，例如变成 /v1/chat/completions/chat/completions 而报404。

② API Key：粘贴上一步复制的SDK Token。

③ 模型名称：填写魔搭平台上的完整模型ID，例如：
deepseek-ai/DeepSeek-R1（纯文本生成）
Qwen/Qwen2.5-VL-72B-Instruct（多模态理解）
Flux.1-dev（创意文生图）。

填写完毕后，点击「保存」。此时配置项已持久化，但尚未验证连通性。

测试模型调用是否成功

方法一：在Dify中新建一个「文本生成」应用，在「模型」下拉菜单中选择你刚配置的魔搭模型，输入提示词如“写一首关于夏天的五言绝句”，点击「运行」。

方法二：直接进入「模型供应商」页面，找到该配置项，点击右侧「测试」按钮，输入任意用户消息，观察返回结果是否含content字段且非空。

若返回错误，优先检查Endpoint末尾是否有斜杠、API Key是否复制完整、模型ID是否与魔搭页面显示的完全一致（区分大小写和斜杠位置）。