模型ID是API调用中唯一生效的凭证，必须填入model字段；名称仅用于人类识别，不参与校验。ID为全小写、含字母数字与下划线的固定字符串，如hunyuan_pro_v202512；名称如“hunyuan-pro”含连字符或大小写，不可直接用于API。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元模型名称和模型ID是调用API时必须区分的两个关键标识，名称用于人类识别功能与版本定位，ID才是系统实际识别并路由请求的唯一凭证，填错ID会导致404或调用失败。
模型名称：面向人的功能描述标签
模型名称是腾讯官方对外发布的、便于用户理解用途与代际关系的字符串，例如 “hunyuan-pro” 表示专业增强版，“hunyuan-turboS” 表示快思考轻量版，“HY4-preview” 表示新一代生产力模型预览版。它不参与API请求校验，仅用于文档查阅、控制台展示和内部沟通。
名称中带连字符、大小写混合、含空格缩写（如“Hy-ASR-3.0-preview”）都是合法命名，但这些字符在API请求中【不可直接填入model字段】——否则会触发参数格式错误。
模型ID：API调用中唯一生效的字符串
模型ID是腾讯云TI平台或TokenHub分配的、全小写、无空格、仅含字母数字与下划线的固定字符串，例如：hunyuan_pro_v202512、hy4_preview_202608、hy_asr_30_preview。
每个模型ID严格绑定具体版本、推理配置与计费策略。同一名称可能对应多个ID：比如“hunyuan-pro”在2025年12月上线时ID为 hunyuan_pro_v202512，2026年8月升级后新增ID hunyuan_pro_v202608，二者能力、上下文长度、token计费单价均不同。
你必须在API请求的 model 字段中填入这个ID，而不是名称。控制台开通服务时显示的“模型名称”旁，一定有灰色小字标注“ID：xxx”，务必复制此处内容。
如何准确获取当前可用的模型ID
第一步：登录 腾讯云混元控制台 → 进入「模型服务」→ 点击「已开通服务」；
第二步：在服务列表中找到目标模型行，查看「模型ID」列内容；
第三步：点击该ID右侧的「复制」图标 → 粘贴到代码中 model 参数位置；
注意：控制台里显示的「模型名称」列不可点击复制，且部分旧版文档仍沿用过期名称（如“hunyuan”），【务必以控制台实时显示的ID为准】，过期ID将返回 HTTP 400 错误。
