腾讯混元API用Postman怎么测试

陌枫酱_1616

陌枫酱_1616

2026-10-05

505人浏览

原创

能用postman调用腾讯混元api:需获取子账号secretid/secretkey,配置6个x-tc-开头的headers(含正确timestamp),body为json格式请求体,手动计算hmac-sha256签名填入x-tc-signature,成功返回200及choices字段。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

腾讯混元api用postman怎么测试

想用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) 获取。

腾讯混元
腾讯混元

腾讯混元是由腾讯公司推出的通用大语言模型与AI助手产品,基于自研的混元大模型体系打造,提供智能问答、内容生成、代码辅助、办公写作、知识检索等能力。用户可以通过网页端、移动端等方式使用,用于学习、工作和内容创作等多种场景。

下载

构造标准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应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

4290

8

软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

4290

8

腾讯混元使用教程大全
腾讯混元使用教程大全

从零开始学习腾讯混元,涵盖AI问答、内容创作、资料整理、办公辅助、代码生成、学习应用等场景,通过实战教程帮助用户快速掌握腾讯混元。

2026.06.11

402

10

腾讯混元Prompt大全
腾讯混元Prompt大全

收录腾讯混元热门Prompt模板,涵盖AI写作、办公文档、自媒体运营、电商推广、代码开发、学习教育等场景,帮助用户获得更高质量AI输出结果。

2026.06.11

425

10

腾讯混元开发平台教程
腾讯混元开发平台教程

面向开发者提供腾讯混元开放平台、API调用、SDK接入、智能体开发、Agent构建及企业级AI应用开发教程,帮助快速完成腾讯混元能力集成。

2026.06.11

441

10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

80

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

80

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

40

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

40

26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程