404说明请求未达混元服务端，主因是Base URL拼写错误或路径缺失；必须核验URL是否完整包含/v1/chat/completions，且域名必须为hunyuan.tencentcloudapi.com，不可误用TokenHub地址。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元接入后调用失败返回404错误，说明请求根本没到达混元服务端，大概率是Base URL拼写错误或路径缺失，必须逐级核验接口地址是否与腾讯云官方文档完全一致。
确认Base URL是否含/v1/chat/completions后缀
打开腾讯云混元控制台→进入「API管理」页面→找到你创建的应用→点击「查看密钥」旁的「接口文档」链接→在「请求地址」栏复制完整URL；【必须包含/v1/chat/completions，缺一个斜杠或少completions都会404】。
常见错误：只复制到https://hunyuan.tencentcloudapi.com，漏掉/v1/chat/completions；或者误用TokenHub的地址（如https://api.tokenhub.tencent.com/v1），该地址不支持chat/completions路由。
区分混元真实API与TokenHub兼容接口
方法一：查控制台入口位置
真实混元API密钥在「混元大模型」控制台→「应用管理」中生成；TokenHub API Key在独立的「TokenHub」控制台生成——两者域名、路径、鉴权方式完全不同，不能混用。
方法二：看URL域名和协议
混元原生API使用hunyuan.tencentcloudapi.com，且仅支持HTTPS；TokenHub兼容接口使用api.tokenhub.tencent.com，走OpenAI兼容协议。若你在Trae或WorkBuddy里填的是TokenHub地址却选了Tencent vendor，必然404。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
注意：TokenHub地址的正确路径是https://api.tokenhub.tencent.com/v1/chat/completions，不是/v1/complete或/v1/chat/completion。
验证Base URL能否被curl直接访问
第一步：打开终端，执行以下命令（将YOUR_API_KEY替换成真实密钥）：
curl -X POST "https://hunyuan.tencentcloudapi.com/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"hunyuan-pro","messages":[{"role":"user","content":"你好"}]}'
第二步：观察返回
如果返回{"error":{"code":"InvalidParameter.Unauthorized","message":"Unauthorized"}}，说明URL正确但密钥无效；【如果返回404或"page not found"，立刻停止操作，回退检查URL】。
第三步：用浏览器打开Base URL根路径（如https://hunyuan.tencentcloudapi.com）
正常应返回腾讯云标准404页面，带“腾讯云”logo和错误提示；若出现Nginx 404或空白页，说明域名解析失败或服务未开通。
