必须先完成API密钥配置和模型服务绑定，否则对话请求会因鉴权失败报错或返回空响应；需在腾讯云控制台申请密钥并填入Cherry Studio设置中的API密钥与地址https://api.hunyuan.cloud.tencent.com/v1/，点击检查确认连接成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Cherry Studio 中使用腾讯混元大模型，必须先完成 API 密钥配置和模型服务绑定，否则所有对话请求都会因鉴权失败而报错或返回空响应。
申请腾讯混元 API 密钥
打开腾讯云控制台混元 API 密钥管理页面 https://console.cloud.tencent.com/hunyuan/api-key，点击【创建 API KEY】按钮生成新密钥。
生成后立即复制密钥内容并保存到本地安全位置——【该密钥仅显示一次，关闭页面后不可再次查看】。若丢失需重新创建，旧密钥将自动失效。
注意：API KEY 是腾讯云混元大模型 API 请求时的安全鉴权凭证，泄露可能导致账户异常调用或费用风险。
在 Cherry Studio 中配置混元服务
启动 Cherry Studio 客户端 → 点击左下角【设置】→ 在【模型服务】页签中搜索“腾讯” → 单击【腾讯混元】条目。
在右侧表单中填写以下两项：
- API 密钥：粘贴上一步复制的密钥字符串
- API 地址：https://api.hunyuan.cloud.tencent.com/v1/（注意末尾必须带 /v1/，缺则连接失败）
填完后点击【检查】按钮，弹出“连接成功”提示即表示基础配置完成。
添加混元其他可用模型（可选）
第一步：在混元配置页面下滑，找到并点击【添加】按钮。
第二步：填写模型信息表单：
- 模型 ID：必须与腾讯官方公布的模型列表完全一致，例如 hunyuan-pro、hunyuan-standard、hunyuan-lite
- 模型名称：系统会根据模型 ID 自动填充，无需手动输入
- 分组名称：建议统一填写为 Hunyuan，便于后续识别
第三步：确认无误后点击【添加模型】，新模型将出现在模型选择下拉列表中。
启用联网功能（如需实时信息）
方法一：在任意聊天窗口右下角点击地球图标，点亮即开启联网模式。
方法二：进入【设置】→【模型服务】→ 找到已启用的混元模型 → 开启【联网搜索】开关。
【仅限混元 Pro 及 Standard 版本支持联网，Lite 版本不支持】
调用混元模型进行对话
点击左侧标签栏的【助手】→ 新建对话 → 在模型选择下拉框中切换为已配置的混元模型（如 hunyuan-pro）→ 输入问题发送即可。
