腾讯混元api key本身不限制模型，实际可调用模型由cam策略、tokenhub访问范围配置及请求中model参数三重校验共同决定：原生api依赖cam权限策略，tokenhub key在创建时锁定模型或通过token plan管控，调用时必须显式指定合法model值并匹配对应平台endpoint。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元API Key本身不直接限制可调用的具体模型，但通过密钥绑定的服务权限、模型接入平台的策略控制以及调用时显式指定的model参数，实际能访问哪些模型由多重机制共同决定。
API Key 与模型权限的关系
腾讯云原生混元 API（即使用 SecretId/SecretKey + CAM 策略调用 hunyuan.v20230901）中，【API Key（即 SecretId/SecretKey）本身不携带模型白名单】，其权限完全依赖于关联的 CAM 策略。若策略仅授予 hunyuan:InvokeModel 权限，则可调用该账号下所有已开通且策略允许的混元模型；若策略限制为 hunyuan:InvokeModel:hunyuan-pro，则无法调用 hunyuan-turbo 或 hy3-preview。
这一步必须在腾讯云控制台 → 访问管理 → CAM → 策略中手动配置，不能靠 API Key 字符串本身控制。
TokenHub 平台的 API Key 模型控制逻辑
TokenHub 提供的 OpenAI 兼容接口所用的 API Key，其模型访问范围在创建时就已锁定：
方法一：创建时勾选模型
登录 TokenHub 控制台 → API Key 管理 → 创建 API Key → 在「访问范围」中勾选具体模型（如仅勾选 hy3-preview 和 glm-5.1），则该 Key 后续只能调用这两个模型。未勾选的模型（如 kimi-k2.6）即使出现在模型列表中，调用时也会返回 403 Forbidden。
方法二：使用「模型分组」或「Token Plan」精细化管控
企业用户可在 TokenHub 中为不同 API Key 分配不同的 Token Plan，每个 Plan 可绑定特定模型集合与调用配额。这种方式无需改密钥，直接在控制台调整 Plan 关联即可切换可用模型集。
调用层强制校验 model 参数
无论使用哪种密钥，请求体中必须传入合法的 model 字段值，否则服务端直接拒绝：
第一步：确认你使用的 model ID 属于混元官方支持列表
例如 hy3-preview、hunyuan-pro、hunyuan-turbo、hunyuan-lite 等，全部需与 官方模型文档 中列出的 ID 完全一致，大小写敏感，多一个空格都会报错 400 InvalidParameter.Model。
第二步：检查请求 header 中的 Authorization 是否匹配对应平台类型
TokenHub 的 Key 必须搭配 OpenAI 兼容 endpoint（如 https://api.tokenhub.tencent.com/v1/chat/completions）使用；而原生混元 SDK 必须用 hunyuan.ai.tencentcloudapi.com 域名 + SecretId/SecretKey。混用会导致 401 Unauthorized，与模型无关。
第三步：发送 POST 请求到 /v1/chat/completions，body 中明确指定：
{"model": "hy3-preview", "messages": [...]}
服务端会校验该 model 是否在当前 Key 的授权范围内，不在则立即返回 403。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
