能用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 名称错误或未开通该模型服务。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










