能用Postman调用腾讯混元API：需获取子账号SecretId/SecretKey，配置6个X-TC-开头的Headers（含正确Timestamp），Body为JSON格式请求体，手动计算HMAC-SHA256签名填入X-TC-Signature，成功返回200及Choices字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用Postman快速验证腾讯混元API是否能正常调用，又不想写代码、不配SDK环境，直接在图形界面发请求看返回结果——这是最常被新手卡住的第一步。
获取合法的API密钥对
登录腾讯云控制台 → 进入【访问管理】→ 【API密钥管理】→ 点击【新建密钥】。系统会生成一对 【SecretId 和 SecretKey】，页面只显示一次，关闭后无法再次查看。务必立即复制并保存到本地安全位置，泄露即等同于账户失守。
注意：不要使用主账号密钥，应创建子账号并授予最小必要权限（如 QcloudHunyuanFullAccess）。
配置Postman的认证头
新建一个 POST 请求，URL 填写：https://hunyuan.tencentcloudapi.com。
在【Headers】选项卡中，逐行添加以下 6 个固定字段：
X-TC-Action: ChatCompletions
X-TC-Version: 2023-09-01
X-TC-Region: ap-guangzhou
X-TC-Language: zh-CN
X-TC-SecretId: 【你刚复制的SecretId】
X-TC-Timestamp: 【当前时间戳，精确到秒，例如 1727635824】
其中 X-TC-Timestamp 必须是当前 Unix 时间戳，误差超过 300 秒服务器将直接拒绝请求。可在浏览器控制台执行 Math.floor(Date.now()/1000) 获取。
构造标准JSON请求体
切换到【Body】→ 选择【raw】→ 左侧下拉选【JSON】。
粘贴以下内容（已适配非流式调用）：
{
"Model": "hunyuan-pro",
"Messages": [
{
"Role": "user",
"Content": "你好，请用一句话介绍你自己"
}
],
"Stream": false
}
必须确保 Content 是字符串类型，不能是对象或空值；Model 名称需与控制台实际开通的模型完全一致（大小写敏感），填错会返回 400 错误且无明确提示。
手动计算并填入签名串
第一步：拼接待签名字符串（CanonicalString），格式为：
POST
/
Action=ChatCompletions&Version=2023-09-01
host:hunyuan.tencentcloudapi.com
x-tc-action:ChatCompletions
x-tc-language:zh-CN
x-tc-region:ap-guangzhou
x-tc-secretid:【你的SecretId】
x-tc-timestamp:【你填的Timestamp】
第二步：用你的 SecretKey 对该字符串做 HMAC-SHA256 签名，再 Base64 编码。
第三步：把编码结果填入 Headers 的 【X-TC-Signature】 字段。
这一步不可跳过，也不支持 Postman 自动签名。推荐用在线工具（如 https://www.devglan.com/online-tools/hmac-sha256-generator）粘贴 SecretKey 和待签名串，选 SHA256 + Base64 输出。填错 signature 会返回 401 Unauthorized。
发送并查看响应
点击 Send 按钮。
若状态码为 200，Body 中出现含 Choices 字段的 JSON，说明调用成功；若返回 {"Error":{"Code":"AuthFailure.SignatureFailure",...}}，请回头核对 Timestamp 是否超时、Signature 是否漏字符、SecretId 是否多空格；若返回 {"Error":{"Code":"ResourceNotFound.ModelNotAvailable",...}}，说明 Model 名称错误或未开通该模型服务。
