必须修改底层服务绑定关系才能切换模型，不能仅前端切换；需先确认当前模型来源，再按云上新模型或本地私有化模型路径操作，并注意生产环境风险与兼容性验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让已上线的腾讯混元智能体（如Hyra-1.0）不再依赖默认模型，而是切换为Hy4 preview、Hy Image3.5或本地部署的HY-1.8B-2Bit等新模型，必须修改其底层服务绑定关系，不能仅在前端界面切换。
确认智能体当前模型绑定方式
登录 TokenHub 控制台 → 进入「智能体管理」→ 找到目标智能体（如Hyra-1.0）→ 点击「配置详情」。查看「模型服务来源」字段：若显示“hunyuan-pro”或“hunyuan-large”，说明当前走的是腾讯云原生API路由；若显示“自定义OpenAI兼容地址”，则已接入第三方网关，后续操作路径完全不同。
⚠️ 注意：【一旦智能体已发布至生产环境且被其他系统调用，直接修改模型ID可能导致历史会话中断或token计费错乱】。务必先在测试环境中验证新模型的schema兼容性。
更换为Hy4 preview等云上新模型
方法一：通过TokenHub控制台快速替换（仅限已上架模型）
进入该智能体的「模型配置」页 → 在「基础模型」下拉菜单中选择“hy4-preview” → 勾选「启用流式响应」→ 点击「保存并重启服务」。系统将自动校验API密钥权限，若提示“模型未授权”，需前往「账户中心→API密钥管理」重新生成密钥并勾选hy4-preview访问权限。
方法二：手动编辑JSON配置（支持未上架模型）
在TokenHub控制台点击「高级配置」→ 切换为「YAML编辑模式」→ 找到model_provider字段，将值从hunyuan-pro改为hy4-preview；同时将endpoint_url从https://api.hunyuan.cloud.tencent.com/v1/更新为https://api.hunyuan.cloud.tencent.com/v2/ → 保存后强制刷新智能体缓存（点击右上角「清空运行时状态」）。
切换至本地私有化模型
第一步：确保本地模型已提供OpenAI兼容接口
例如使用vLLM部署HY-1.8B-2Bit时，启动命令必须包含--enable-openai-compatible-api参数，否则TokenHub无法识别。
第二步：在智能体配置中填写自定义模型信息
回到「模型配置」页 → 选择「自定义模型」→ 在「API地址」栏填入本地服务地址（如http://192.168.1.100:8000/v1）→ 「API密钥」留空（本地模型无需鉴权）→ 「模型名称」填入hy-1.8b-2bit → 点击「连接测试」，看到{"message":"success"}即表示通路正常。
第三步：强制指定请求头绕过云端校验
在「高级配置→请求头设置」中新增键值对：X-Model-Provider: self-hosted。这一步不可省略，【否则TokenHub会默认添加腾讯云鉴权头，导致本地服务拒绝请求】。
