在部署过程中，你极大概率会遇到这样一个状况：在Dify中投入大量精力搭建好工作流，也顺利配置了聊天机器人，但一运行却直接报错“模型不可用”——不必慌张。要解决这个问题，让AI应用真正运转起来，有一个关键步骤无法绕开：在Dify中正确配置API密钥，并绑定模型。

下面以通义千问为例，手把手带你走完完整的配置流程。

第一步：从阿里云百炼获取API密钥

启动浏览器，访问阿里云百炼控制台的API密钥管理页面。操作前需确认两个前提条件：第一，账号已完成实名认证，否则系统将强制跳转，无法创建密钥；第二，请提前准备好记录工具，因为密钥只显示一次。

点击【创建API密钥】，系统会生成一对值：AccessKey ID和AccessKey Secret。请注意，关闭页面后这对值将永久不可见。重要提醒：务必立即复制并妥善保管AccessKey Secret。一旦丢失，除了删除重建之外别无他法，而旧密钥关联的所有Dify应用会瞬间失效，这个代价不可忽视。

第二步：在Dify管理后台关联百炼密钥

登录你的Dify管理后台——地址可能是本地的 http://localhost，也可能是部署在服务器上的域名。进入左侧菜单【设置】→【模型供应商】。

点击右上角的【+ 添加模型供应商】，在弹出的窗口中选择【通义千问（Qwen）】作为模型提供商。接下来填写关键信息：

「Base URL」保持默认即可，即 https://dashscope.aliyuncs.com/api/v1，除非你使用的是私有化部署地址。核心字段如下：

「API Key」字段粘贴刚才复制的AccessKey Secret
「Access Key ID」字段粘贴对应的AccessKey ID

勾选「启用」开关，点击【保存】。此时页面顶部会弹出绿色提示“模型供应商保存成功”，但先别急着庆祝——这只是配置保存成功，尚未验证连通性。

第三步：让模型真正生效

保存完成后，返回【模型供应商】列表，找到刚添加的通义千问条目，点击右侧的【测试连接】按钮。这个步骤至关重要，可以验证密钥是否有效、网络是否可达、权限是否正常。

等待大约3秒钟。如果显示“连接成功”，那么恭喜，接下来只需完成最后一步即可。如果测试失败，排查方向有三个：① 是否复制错误，把Secret当成了ID，或者反过来；② 去百炼控制台检查该密钥的状态是否为“启用”；③ Dify服务器能否正常访问 dashscope.aliyuncs.com——企业网络防火墙常常拦截这个域名，这也是最常见的故障原因。

连接成功后，进入【模型管理】，点击【+ 添加模型】。模型名称填写你已开通额度的型号，例如 qwen-max、qwen-plus 或 qwen-turbo。供应商选择刚才配置好的通义千问条目。点击【保存】。

刷新页面，模型便会出现在可用列表中。至此，你的Dify应用终于可以成功调用通义千问大模型生成内容——无论是工作流、聊天机器人还是知识库问答，都不会再因为“模型不可用”而中断了。