secretid和secretkey不能互换使用，因为secretid是公开身份标识（如用户名），secretkey是严格保密的加密密钥，用于生成hmac-sha256签名；若用secretid代替secretkey计算签名，服务端校验必失败并返回401 unauthorized。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API调用时必须同时提供SecretId和SecretKey，二者缺一不可，不能互相替代——因为它们在鉴权流程中承担完全不同的角色：SecretId用于标识身份，SecretKey用于生成签名，单独任一参数都无法完成API 3.0签名认证。
为什么SecretId和SecretKey不能互换使用
SecretId是公开可传输的身份标识符，类似用户名；SecretKey是严格保密的加密密钥，用于对请求参数生成HMAC-SHA256签名。腾讯云API 3.0协议要求每次请求都携带签名，而签名必须由SecretKey参与计算，【若用SecretId代替SecretKey生成签名，服务端校验必然失败，返回401 Unauthorized】。
这一步没有容错空间——SDK底层会直接报错“InvalidSignature”，不会进入模型推理环节。
TokenHub API Key和CAM密钥的区别
TokenHub API Key是混元大模型OpenAI兼容接口专用凭证，格式为sk-xxx，仅用于/v1/chat/completions等路径；而SecretId/SecretKey是腾讯云通用API 3.0凭证，用于hunyuan.v20230901等原生SDK接口。
两者鉴权体系不同，不能混用。例如用TokenHub Key去初始化tencentcloud-sdk-python的HunyuanClient，会触发“InvalidEndpoint”错误。
注意：【TokenHub API Key不等于SecretKey，也不能通过SecretId推导出来】，它们由不同系统独立签发。
如何确认自己用对了密钥类型
第一步：打开你的代码中初始化客户端的位置
第二步：检查是否匹配以下任一模式
→ 若调用的是OpenAI兼容接口（如curl -X POST https://api.hunyuan.tencent.com/v1/chat/completions），则必须使用TokenHub API Key，并放在Authorization头中：Bearer sk-xxx
→ 若调用的是原生腾讯云SDK（如from tencentcloud.hunyuan.v20230901 import hunyuan_client），则必须传入SecretId和SecretKey两个参数，缺一不可
第三步：核对控制台来源——TokenHub Key来自https://console.cloud.tencent.com/tokenhub/，SecretId/SecretKey来自https://console.cloud.tencent.com/cam/capi/
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
