需使用Bearer Token认证访问https://api.hunyuan.cloud.tencent.com/v1/chat/completions，headers设Content-Type和Authorization，请求体含合法model、非空messages，密钥须有HunyuanInvokeAccess权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用 Python 调用腾讯混元大模型的 chat/completions 接口，但不确定参数怎么填、headers 怎么设、请求体结构怎么组织，容易因字段名错误或缺失关键字段导致 401 或 400 错误。
确认接口地址与认证方式
打开腾讯云 API 文档页面，定位到「混元 OpenAI 兼容接口」章节，找到 chat/completions 接口的完整请求地址：https://api.hunyuan.cloud.tencent.com/v1/chat/completions。这个地址不能省略 /v1/，也不能替换成旧版 tencentcloudapi.com 域名，否则直接返回 404。
认证方式必须使用 Bearer Token，不是 X-TC-SecretId/X-TC-SecretKey 那套签名机制——这是 OpenAI 兼容模式的关键前提，【填错认证方式会导致 401 Unauthorized】。
准备合法的 API Key
登录腾讯云控制台 → 进入「API 密钥管理」→ 创建新的密钥对 → 复制生成的 SecretKey（注意不是 SecretId）。
该密钥需具备 HunyuanFullAccess 或至少 HunyuanInvokeAccess 权限策略，否则调用时会返回 UnauthorizedOperation 错误码。
构造标准请求体（JSON 格式）
第一步：定义 messages 列表，至少包含一个 role=user 的字典，content 字段不能为空字符串或纯空格。
第二步：指定 model 字段值，必须从官方支持列表中选取，例如 "hunyuan-pro"、"hunyuan-turbos-latest"，不能拼错大小写或加空格，【model 值非法会触发 400 Bad Request 并提示 unknown model】。
第三步：可选添加 enable_enhancement=true 启用知识增强，不加则默认关闭；若需流式响应，额外增加 stream=true 字段并处理 SSE 数据流。
用 requests 发起调用（推荐方式）
方法一：基础同步调用
导入 requests 库 → 设置 headers 包含 "Content-Type": "application/json" 和 "Authorization": "Bearer sk-xxx"（sk- 开头密钥需完整粘贴）→ 使用 json= 参数传入构造好的字典 → 检查 response.status_code 是否为 200 → 用 response.json() 解析返回。
方法二：带错误重试的健壮调用
用 requests.Session() 实例 → 设置 adapter 的 max_retries=2 → 对 status_code 非 200 的响应，捕获 requests.exceptions.RequestException 并打印 response.text → 特别注意当返回 {"code":1001,"message":"Invalid API key"} 时，说明密钥已失效或未启用。
