必须使用腾讯云控制台“模型列表”中状态为“已开通”的精确模型id，区分大小写和连字符；openrouter需加tencent/前缀，tokenhub则用原生id。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在调用腾讯混元API时准确填写model参数，否则请求会直接返回404或“model not found”错误。这个参数不是随意写个名字就能用的，必须与腾讯云当前实际开放的模型ID完全一致，大小写、连字符、版本标识都不能出错。
查清可用模型ID的官方来源
打开腾讯混元控制台：https://console.cloud.tencent.com/hunyuan/start → 点击左侧「模型服务」→ 进入「模型列表」页面。这里展示的是你账号当前已开通权限、且处于可用状态的全部模型，每行包含「模型ID」「模型名称」「状态」三列。只有状态为「已开通」的模型ID才可填入API请求。
注意：【不同地域开通的模型可能不同，例如ap-guangzhou可用hy4-preview，而ap-beijing可能尚未开放】。如果你在控制台没看到想要的模型，请先切换右上角地域，再确认是否需手动开通服务。
常见合法model参数值（截至2026年9月30日）
以下为当前主流可用模型ID，直接复制使用即可：
• hunyuan-pro（稳定版主力模型，适合通用对话与文本生成）
• hy3（295B混合专家架构，推理与代码能力强化，免费期已结束但商用仍开放）
• hy4-preview（新一代生产力模型，支持960K上下文，Agent任务首选）
• hunyuan-vl（多模态理解模型，支持图文输入）
• hunyuan-image（文生图专用模型，需配合图像生成接口使用）
不要写成 hunyuan_pro、Hunyuan-Pro、hy4 或 hy4-preview-2026，这些写法全部无效。模型ID是严格区分大小写和连字符的字符串，不是描述性名称。
OpenAI兼容接口下的特殊写法
如果你通过TokenHub或OpenRouter等OpenAI兼容网关调用混元，model字段必须使用其映射后的ID，而非腾讯云原生ID：
方法一：TokenHub网关
• 请求地址为 https://tokenhub.tencentmaas.com/v1/chat/completions 时，model应填：
hy4-preview（对应腾讯云原生 hy4-preview）
hy3（对应腾讯云原生 hy3）
hunyuan-pro（对应腾讯云原生 hunyuan-pro）
方法二：OpenRouter网关
• 请求地址为 https://openrouter.ai/api/v1/chat/completions 时，model应填：
tencent/hy4-preview
tencent/hy3
tencent/hunyuan-pro
【关键区别：OpenRouter强制要求带命名空间前缀 tencent/，漏掉就会报错】
验证model是否生效的最快方式
第一步：用curl发一个最简请求，只带必需字段：
curl -X POST 'https://api.hunyuan.cloud.tencent.com/v1/chat/completions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "model": "hunyuan-pro", "messages": [{"role":"user","content":"测试"}] }'
第二步：观察响应体。如果返回"error":{"code":"ModelNotFound","message":"The model `hunyuan-pro` does not exist or is not available."，说明该模型未在你所选地域开通，需回控制台检查；如果返回完整response且choices[0].message.content非空，说明model填写正确。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
