必须先完成api密钥配置与模型注册，否则工作流节点报“模型不可用”错误且无提示；需登录dify→设置→模型供应商→安装腾讯云卡片→填入具备hunyuan:invoke权限的子用户secret id和secret key→保存后显示“已启用”；密钥须为广州、上海或北京地域生成，否则连接失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中调用腾讯混元大模型，必须先完成API密钥配置与模型注册，否则所有工作流节点都会报“模型不可用”错误，且界面不提示具体原因。
配置腾讯混元API密钥
登录Dify管理后台→右上角头像→设置→模型供应商→点击“腾讯云”卡片右侧的安装按钮。
在弹出表单中填入腾讯云访问密钥：【Secret ID 和 Secret Key 必须来自具备 hunyuan:Invoke 权限的子用户，主账号密钥因安全策略默认被Dify拒绝】。填写后点击保存，页面底部会显示“已启用”绿色提示。
这一步失败最常见的原因是密钥权限不足或地域不匹配——混元API当前仅开放广州、上海、北京三地接入点，若密钥生成时选择的是成都地域，则无法通过连接检查。
添加混元具体模型（非必选但强烈建议）
方法一：使用Dify内置默认模型
保存密钥后，无需额外操作，Dify会自动拉取混元可用模型列表，hunyuan-pro、hunyuan-turbo等基础型号将出现在模型下拉菜单中。
方法二：手动添加定制化模型ID
在模型供应商页面下滑，点击“添加模型”→模型ID填写 hunyuan-lite（注意拼写，大小写敏感）→模型名称自动填充为“混元轻量版”→分组名称输入 Hunyuan →点击添加模型。该操作会覆盖默认模型列表中的同名项，确保后续工作流精准调用指定版本。
在知识库或工作流中启用混元
第一步：进入知识库→编辑知识库→嵌入模型下拉框中选择“腾讯混元Embedding”（此为向量化专用模型，与生成模型分离）。
第二步：创建RAG问答智能体→工作流节点中定位到llm_generate节点→在模型配置项中选择“hunyuan-pro”或你手动添加的“混元轻量版”。【若此处下拉菜单为空，请返回检查API密钥是否保存成功且未被禁用】
第三步：保存工作流→点击“发布”→在测试面板输入问题，观察响应头部是否出现 X-Model-Used: hunyuan-pro 字样，确认调用链路已打通。
