必须执行端到端连通性测试：先用SecretId/SecretKey调用DescribeModel验证原生接口，再用TokenHub API Key通过OpenAI兼容接口测试chat/completions，最后在Dify中调试会话确认answer字段返回非空内容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要确认腾讯混元模型已真正接入并可被调用，必须执行一次端到端的连通性测试——不是只看后台配置是否保存成功，而是让系统实际发起一次请求、收到有效响应、解析出合理文本，才算真正打通。
准备测试所需的最小凭证组合
打开腾讯云控制台 → 进入【混元大模型】→ 【API密钥管理】页面。确认已创建至少一个密钥对，且状态为“启用”。【SecretKey仅在创建时完整显示一次，关闭页面后不可恢复】。若已丢失，必须删除旧密钥并新建——不要尝试用旧密钥重试，它已失效。
复制当前密钥的 SecretId 和 SecretKey。注意：这不是 TokenHub 的 API Key，也不是 CAM 的临时凭证；混元原生接口必须使用这对密钥。
构造最简 HTTP 请求验证服务可达性
打开任意支持发送 POST 请求的工具（如 curl、Postman、VS Code REST Client 插件或浏览器插件 Thunder Client）。
向地址 https://hunyuan.tencentcloudapi.com 发送 POST 请求，Headers 中必须包含：Content-Type: application/json; charset=utf-8，Body 为标准 JSON：
{"Action":"DescribeModel","Version":"2023-09-01","Region":"ap-guangzhou"}
这一步不涉及模型推理，只查询模型元信息。若返回 "Code": "Success" 且含 "ModelList" 字段，说明网络通、鉴权通、服务端正常——这是最轻量但最关键的连通性证据。若返回 401 或 403，检查 SecretId/SecretKey 是否粘贴错误；若返回 404 或超时，检查 Endpoint 是否写成 api.hunyuan.cloud.tencent.com（那是 OpenAI 兼容接口地址，不适用于此原生调用）。
用 OpenAI 兼容接口做二次验证（推荐）
方法一：使用 curl 命令行直连
执行以下命令（替换 YOUR_API_KEY 为你的 TokenHub API Key，不是 SecretKey）：
curl -X POST https://api.hunyuan.cloud.tencent.com/v1/chat/completions \-H "Authorization: Bearer YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model": "hunyuan-pro", "messages": [{"role": "user", "content": "你好"}]}'
方法二：在 Postman 中新建请求，URL 填 https://api.hunyuan.cloud.tencent.com/v1/chat/completions，Headers 加 Authorization: Bearer YOUR_API_KEY，Body 选 raw → JSON，填入同上结构的 JSON。
成功响应必须包含 "choices"[0]["message"]["content"] 且内容非空。若返回 "error": {"message": "Invalid API key"}，说明你误用了 SecretKey 当作 TokenHub Key；若返回 "model not found"，说明所填 model 名称不在当前账号开通列表中，需回控制台确认已开通 hunyuan-pro 权限。
在 Dify 中触发调试会话
第一步：进入 Dify 管理后台 → 【工作室】→ 打开任意已绑定混元模型的文本生成应用。
第二步：点击右上角【调试】按钮 → 在输入框中输入“测试” → 点击【运行】。
第三步：观察响应区域。若出现完整 JSON 响应体，且 "answer" 字段有非空字符串（如“你好！我是混元大模型。”），则连通性测试完成。若卡在“加载中”超过 30 秒，或弹出红色提示“模型不可用”，说明 Dify 后端容器无法访问混元服务端——常见原因是 Docker 部署时用了 localhost，应改为 host.docker.internal 或宿主机真实局域网 IP。
