必须先完成一次成功的API对话请求，否则后续调用只是本地空转；需在TokenHub创建全选权限的API Key并用cURL验证，返回choices[0].message.content含合理中文回复即成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让腾讯混元大模型真正开始说话，必须先完成一次成功的API对话请求，否则后续所有调用都只是本地空转。
获取合法的API密钥
登录腾讯云控制台 → 进入 TokenHub 管理页（不是 CAM 密钥页）→ 创建新 API Key → 命名如“hunyuan-dev” → 访问范围勾选「全选」→ 点击确定后【立即复制并离线保存】，该密钥仅显示一次，丢失需重新生成。
注意：混元 OpenAI 兼容接口只认 TokenHub 的 API Key，用错 CAM 的 SecretId/SecretKey 会直接返回 401 错误且无提示。
用 cURL 发起首次对话（终端直跑验证）
打开命令行终端（Windows PowerShell / macOS Terminal / Linux Bash），粘贴以下命令：
curl https://api.hunyuan.cloud.tencent.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "model": "hunyuan-turbos-latest", "messages": [{ "role": "user", "content": "Hello, are you ready?" }], "enable_enhancement": true }'
把 YOUR_API_KEY 替换成你刚复制的密钥，回车执行。这一步操作起来很简单，直接把命令粘贴进去就行。
若返回 JSON 中包含 【choices[0].message.content 字段且内容为合理中文回复】（例如“是的，我已准备就绪！”），说明调用成功；若报 401，请检查 Authorization 头是否漏了 Bearer 前缀或密钥末尾有空格；报 429 表示当前账号并发超限（默认仅允许 5 路）。
用 Python SDK 发送第一条请求
方法一：安装官方 SDK
pip install tencentcloud-sdk-python
方法二：编写最小可运行脚本
第一步：导入必要模块 → 第二步：初始化 client 实例，填入 Region（必须为 ap-guangzhou）、SecretId、SecretKey（注意：此处用的是 CAM 密钥，与 TokenHub Key 不同）→ 第三步：构造 request 对象，设置 Action="ChatCompletions"、Model="hunyuan-turbos-latest"、Messages=[{"Role":"user","Content":"你好"}] → 第四步：调用 client.ChatCompletions(request) 并打印 response.OutputMessage.Content。
SDK 方式适合集成进项目，但首次验证建议优先用 cURL，避免环境依赖干扰判断。
