API Key申请后须立即验证可用性，通过AI客户端配置页粘贴密钥并保存，再点击“测试连接”执行文本生成测试；若失败，用curl或PowerShell手动发送hi请求，检查响应是否含choices及非空content，否则检查模型名是否匹配官方文档列表。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API Key申请完成后，必须立即验证其是否真实可用，否则后续所有调用都会失败且无法定位是密钥问题还是代码问题。
进入AI配置界面粘贴并保存
打开你正在使用的AI客户端（如LobeChat、AnythingLLM或自研应用），进入「设置」→「AI配置」或「语言模型」页面。
在“API Key”输入框中，【粘贴刚从腾讯云复制的完整API KEY】，注意不要多空格、少字符，也不能包含中文引号或换行符。
点击“保存”或“应用更改”，部分软件会自动触发本地缓存刷新；若无反应，手动关闭再重开该配置页。
执行文本生成测试
回到AI配置页，找到“测试功能”或“Test Connection”按钮，点击它。
选择“文本生成测试”（不是对话测试或Embedding测试），系统将自动发送一条极简请求到混元服务端。
如果返回结果含“Hello”“你好”或类似基础响应，说明API KEY已通；若弹出“Unauthorized”“Invalid API Key”或超时无响应，则密钥无效或未生效。
手动验证：用curl发一次最简请求
方法一：终端执行（macOS/Linux）
打开终端，运行以下命令（把 YOUR_API_KEY 替换成你的实际密钥）：
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-standard","messages":[{"role":"user","content":"hi"}]}'
方法二：Windows PowerShell（管理员权限非必需，但需启用TLS 1.2）
执行：$headers=@{"Authorization"="Bearer YOUR_API_KEY";"Content-Type"="application/json"}; Invoke-RestMethod -Uri "https://api.hunyuan.cloud.tencent.com/v1/chat/completions" -Method Post -Headers $headers -Body '{"model":"hunyuan-standard","messages":[{"role":"user","content":"hi"}]}'
看到JSON响应中包含"choices":[{...}]且"content"字段非空，即为成功。若返回"error":{"code":"Unauthorized"，说明密钥错误或未激活。
检查模型名称是否匹配平台当前支持列表
第一步：访问混元官方模型文档页 → 打开 https://www.php.cn/link/54dcb6a67f25e093cedc6809e03bcdd7
第二步：确认你配置的模型名（如hunyuan-pro）确实在文档“可用模型”表格中，且状态为“已上线”。【模型名大小写敏感，且不可带空格或下划线以外的符号】
第三步：回到AI配置页，在“模型”字段中粘贴该准确名称，按回车键新增——不是点击保存，是回车确认新增。
第四步：重新运行上一步的curl测试，此时若仍失败，基本可排除密钥问题，转向排查地域、网络代理或TokenHub迁移影响。
