必须为每个腾讯混元模型单独注册配置项才能在CherryStudio中切换调用；需先配置ap-guangzhou地域的SecretId/SecretKey并验证连接，再逐个添加模型ID（如hunyuan-pro或tencent/hy3-preview）、分组填Hunyuan；腾讯云原生模型用腾讯密钥和官方地址，OpenRouter模型用其API Key和对应地址，二者不可混用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在CherryStudio中同时接入并管理腾讯混元多个模型（如hunyuan-standard、hunyuan-pro、hy3-preview、hy4-preview等），必须在统一API密钥基础上，为每个模型单独注册配置项，否则界面仅显示默认模型，无法切换调用。
配置基础API密钥
点击客户端左下角的 设置 → 在模型服务中搜索并单击 腾讯混元 → 在右侧表单填入有效 SecretId 与 SecretKey，API地址固定为 https://api.hunyuan.cloud.tencent.com/v1/ → 点击【检查】，弹出“连接成功”提示后方可进行下一步。
【必须使用ap-guangzhou地域】 否则后续模型调用会返回401或超时错误；SDK内部默认绑定该地域，不支持运行时覆盖。
添加额外混元模型
在完成基础密钥配置的同一页面，向下滚动至底部 → 单击【添加】按钮 → 弹出新模型配置表单。
按以下顺序填写：
- 模型 ID：严格匹配官方列表，例如
hunyuan-pro、tencent/hy3-preview、tencent/hy4-preview（注意OpenRouter平台需带tencent/前缀）； - 模型名称：留空，系统将自动填充为对应ID的可读名；
- 分组名称：统一填写 Hunyuan，便于左侧模型选择器归类；
- 点击【添加模型】，该模型立即出现在助手页的模型下拉菜单中。
每添加一个模型都需重复上述流程；若填错模型 ID，添加后不会报错但调用时返回 404 Not Found —— 此时需删除重配，不可编辑已添加项。
区分不同平台来源的模型
方法一：对接腾讯云原生API（如 hunyuan-standard、hunyuan-pro）
模型 ID 直接使用官方命名，无需前缀；调用走腾讯云签名认证，依赖 SecretId/SecretKey 和 ap-guangzhou 地域。
方法二：对接OpenRouter平台（如 tencent/hy3-preview、tencent/hy4-preview）
模型 ID 必须带 tencent/ 前缀；API地址需替换为 OpenRouter 的统一端点 https://openrouter.ai/api/v1/；密钥字段填写 OpenRouter 提供的 API Key，而非腾讯云密钥。
【切勿混用密钥与地址】 用腾讯云密钥却填OpenRouter地址，或反之，均导致鉴权失败且错误信息模糊（常表现为“invalid request”而非明确的 auth error）。
