要在Dify中调用腾讯混元大模型，必须先配置模型提供商并确保服务可达：①在【模型配置】中添加“Tencent Hunyuan”提供商，使用自定义OpenAI兼容接口填写正确地址（如host.docker.internal）并测试连接；②创建文本生成应用后，在【模型配置】中选择对应混元模型；③配置腾讯云SecretID/SecretKey或临时Token；④通过【调试】验证Prompt返回成功响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中调用腾讯混元大模型生成文本，必须先让Dify后端能稳定访问混元模型服务，否则所有应用创建和Prompt调试都会卡在“模型不可用”错误上，根本无法进入实际生成环节。
确认混元模型服务已接入Dify后台
登录Dify管理后台（http://localhost:80 或你的部署域名），点击左侧【模型配置】→【大模型提供商】。
检查列表中是否已存在“Tencent Hunyuan”类型提供商；若未出现，需由管理员手动添加。
点击【+ 添加模型提供商】→ 选择“自定义OpenAI兼容接口”→ 填写混元模型部署地址（例如 vLLM 启动的 http://127.0.0.1:8000/v1）→ 设置API Key（若启用鉴权）→ 点击【测试连接】成功后保存。
【必须确保模型服务已启动且能被Dify容器网络访问】，否则后续所有步骤都会卡在“模型不可用”报错。Docker部署时localhost通常指向容器自身，应改用host.docker.internal或宿主机局域网IP。
创建文本生成应用并绑定混元模型
进入【工作室】→ 点击【+ 创建应用】→ 选择“文本生成（Generation）”类型 → 填写应用名称（如“混元古诗生成器”）→ 点击【创建】。
在新建应用编辑页，找到右侧【模型配置】面板 → 展开【基础模型】下拉菜单 → 从中选中类似 hunyuan-7b-chat、hunyuan-mt-7b 或你自定义命名的混元模型选项。
这一步不能跳过：如果下拉列表为空，说明上一步的模型提供商未正确加载，或Dify未从服务端获取到可用模型列表，需返回【模型配置】重新核对服务地址与响应内容。
配置腾讯云密钥（适用于官方混元API直连）
方法一：使用腾讯云CAM密钥直连
点击右上角头像 → 【设置】→ 【模型供应商】→ 找到“Tencent Hunyuan”卡片 → 点击【安装】（若未安装）或【配置】→ 填入腾讯云控制台获取的 SecretID 和 SecretKey → 保存。
SecretID 和 SecretKey 需从 腾讯云访问密钥管理页面 获取，务必开启对应账号的混元大模型调用权限。
方法二：使用临时Token（适合调试环境）
在【模型供应商】中选择已安装的 Tencent Hunyuan → 编辑 → 将“认证方式”切换为 Token → 填入通过腾讯云 STS 服务签发的临时凭证 → 设置有效期（建议≤6小时）→ 保存。
临时Token无需长期暴露密钥，但每次过期后需重新生成并更新配置，生产环境不推荐使用。
验证模型调用是否生效
第一步：在刚创建的文本生成应用中，进入【提示词编排】页签。
第二步：在编辑框中输入测试Prompt，例如：“请用七言绝句描写西湖春景。”
第三步：点击右上角【调试】按钮 → 观察右侧输出区域是否返回合理诗句文本，且状态栏显示“success”及耗时数值。
第四步：若返回错误，重点查看日志中的 HTTP 状态码——401 表示密钥无效，403 表示权限不足，429 表示额度超限，503 表示模型服务不可达。
第五步：调试成功后，该应用即可发布为API或嵌入前端页面，无需额外编码。
