api key（secretid）是公开标识符，用于标识身份；secretkey是私有密钥，用于证明身份，泄露会导致账号被冒用。二者必须成对用于腾讯云原生sdk，而openai兼容接口仅需单字符串api key，不可混用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API Key和SecretKey有什么区别
当你在腾讯云控制台申请混元大模型调用权限时，系统会同时生成一对密钥：API Key（实际指SecretId）和SecretKey，它们共同构成身份认证的唯一凭证，但角色完全不同——SecretId用于标识你是谁，SecretKey用于证明你确实是那个人。
SecretId是公开标识符，SecretKey是私有密码
SecretId就像你的身份证号码，它本身不敏感，会在部分日志、错误响应或SDK初始化代码中出现；而SecretKey相当于银行卡密码，一旦泄露，他人可完全冒用你的账号调用模型、产生费用甚至访问其他已授权资源。
腾讯云自2023年11月30日起已关闭所有账号对SecretKey的二次查看功能，【创建时未复制保存，就永远无法找回】，只能删除旧密钥后新建。
两种密钥生成路径对应不同接入方式
方法一：通过「API密钥管理」创建 → 得到SecretId + SecretKey组合
适用于使用腾讯云原生SDK（如tencentcloud-sdk-python）的开发者，需在代码中显式传入二者。
方法二：通过「创建API KEY」入口生成 → 得到单个字符串格式的API Key
适用于兼容OpenAI接口规范的场景（如LangChain、Ollama、沉浸式翻译插件），此时只需填入该字符串，base_url指向混元API地址即可，无需SecretId。
注意：这两种密钥不能混用。用原生SDK却只填了OpenAI风格的API Key，会返回401鉴权失败；反之，把SecretKey当API Key填进OpenAI兼容接口，也会因签名机制不匹配而报错。
安全实践建议
第一步：登录腾讯云控制台 → 进入「访问管理」→ 「API密钥管理」→ 点击「新建密钥」。
第二步：勾选「子用户」并为其单独授权最小必要权限（如QcloudHunyuanFullAccess策略），避免主账号密钥直接暴露。
第三步：创建成功后立即复制SecretKey → 粘贴进本地密钥管理工具（如1Password）或环境变量文件（.env），【绝不在代码中硬编码，也不上传至Git仓库】。
第四步：在SDK初始化处引用环境变量，例如os.getenv("TENCENT_SECRET_KEY")。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
