必须完成模型供应商配置、API密钥绑定与模型开关启用三步，缺一不可；需在阿里云百炼北京地域获取Secret Key，在Dify中安装通义千问插件并准确填写凭据，再启用具体模型并测试连接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中稳定调用阿里通义千问模型，必须完成模型供应商配置、API密钥绑定与模型开关启用三个关键动作，缺一不可——漏掉任一环节都会导致应用创建后提示“模型不可用”或测试对话无响应。
获取阿里云百炼平台API Key
打开浏览器，访问 阿里云百炼控制台，使用阿里云主账号登录。
点击左上角「API密钥管理」→「创建API密钥」→复制生成的Secret Key（注意：Key仅显示一次，关闭页面后无法再次查看）。
【务必确认地域为北京】——若你在海外账号下操作，默认地域是新加坡，但Dify当前仅支持接入内地地域的通义千问服务，选错将导致后续所有测试失败。
在Dify中安装并配置通义千问插件
登录Dify控制台 → 右上角头像 → 「设置」→「模型供应商」。
在模型市场搜索框输入“通义千问”，找到官方插件 → 点击「安装」（首次安装可能失败，多点几次即可）。
安装成功后，在「待配置」区域找到通义千问条目 → 点击「设置」→ 填写：凭据名称（如“阿里大模型”）、API Key（粘贴刚才复制的Secret Key）→ 点击「保存」。
这一步操作起来很简单，直接把密钥粘进去点保存就行，但千万别手抖多空格或换行——Dify会静默拒绝带不可见字符的Key，且不报错，只让后续测试一直卡在loading状态。
启用具体模型并验证连接
第一步：点击「显示模型」按钮，展开可用模型列表。
第二步：勾选你需要启用的模型，例如 qwen-max、qwen-plus 或 qwen-vl-max（多模态场景必选后者）。
第三步：返回该模型行末尾，点击「测试连接」→ 输入任意中文句子（如“你好”）→ 等待返回正常响应文本。
如果返回超时或报错401，请立即检查API Key是否粘贴完整、地域是否为北京、模型开关是否已开启——这三个条件必须同时满足，缺一不可。
