调用腾讯混元API需按接口类型严格配置请求头：OpenAI兼容接口用Authorization（Bearer sk-xxx）和Content-Type（application/json），base_url为https://api.cloudai.tencent.com/；Anthropic兼容接口用ANTHROPIC_AUTH_TOKEN，base_url为https://api.hunyuan.cloud.tencent.com/anthropic；原生接口则需X-TC-Action等6个签名头，禁用Authorization。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用腾讯混元API时，请求头字段填写错误会导致401未授权、400参数错误或直接被网关拦截，必须严格按接口类型区分配置。
OpenAI 兼容接口（如混元生图、文本生成）
使用 OpenAI SDK 方式接入时，请求头只需两个字段：
① Authorization：值为 【Bearer sk-xxx】，其中 sk- 开头的密钥需在腾讯云控制台「API KEY 管理」中创建，类型必须选「OpenAI 兼容方式」；若误用 SDK 方式的 SecretId/SecretKey，请求将直接失败。
② Content-Type：固定填 application/json，不可写成 text/json 或省略。
注意：base_url 必须为 https://api.cloudai.tencent.com/，不能拼错为 cloud.tencent.com 或 hunyuan.cloud.tencent.com——后者是 Anthropic 兼容接口专用地址。
Anthropic 兼容接口（如 hunyuan-2.0-thinking）
该类接口不接受 Authorization 字段，必须改用以下组合：
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法一：使用 ANTHROPIC_AUTH_TOKEN 请求头
值为 【sk-xxx】，密钥同样需在控制台「API KEY 管理」中创建，但必须选择「Anthropic 兼容方式」；若复用 OpenAI 类型密钥，会返回 403 Forbidden。
方法二：通过环境变量注入（适用于 Claude CLI 或 SDK）
设置 ANTHROPIC_AUTH_TOKEN=sk-xxx，同时 base_url 必须为 https://api.hunyuan.cloud.tencent.com/anthropic。
腾讯云原生 API（如 SubmitHunyuan3DPartJob）
这类接口走标准腾讯云签名流程，请求头不含 Authorization，而是强制要求以下 6 个公共头：
· X-TC-Action：接口名，如 SubmitHunyuan3DPartJob
· X-TC-Version：版本号，如 2025-05-13
· X-TC-Region：地域，如 ap-guangzhou
· X-TC-Timestamp：当前 Unix 时间戳（秒级）
· X-TC-SecretId：SDK 方式申请的 SecretId（非 sk- 开头）
· X-TC-Signature：由 SecretKey 对请求内容生成的 HMAC-SHA256 签名
这一步不可跳过签名计算，直接填 SecretKey 当作签名会触发 401 错误；推荐用腾讯云官方 SDK 自动生成，避免手算出错。
