必须新建API Key并手动更新客户端:在TokenHub创建勾选OpenAI兼容模式的新密钥,立即复制SecretKey;LobeChat或Cherry Studio中替换旧Key、校验地址与连通性;最后删除旧密钥并测试生成请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在已接入混元AI的软件中替换旧API Key,但腾讯云后台不支持直接编辑已有密钥,必须新建并手动更新到客户端。
在腾讯云控制台创建新API Key
打开 TokenHub 控制台 → 左侧导航栏点击「API密钥管理」→ 点击右上角「创建API KEY」。
填写名称(如 hy3-replace-202610),勾选「OpenAI兼容模式」→ 点击「确认」生成。
生成后立即复制完整API Key值,【SecretKey仅首次展示,关闭页面后不可再次查看】。
在客户端软件中更新API Key
方法一:LobeChat
点击右上角「设置」→「语言模型」→ 找到已配置的「腾讯混元」条目 → 点击右侧「编辑」图标 → 将新API Key粘贴进「API Key」输入框 → 点击「检查」验证连通性 → 点击「保存」。
方法二:Cherry Studio
打开软件 → 「设置」→「模型服务」→ 搜索「腾讯」并选中「腾讯混元」→ 删除原API Key内容 → 粘贴新Key → API地址保持为 https://api.hunyuan.cloud.tencent.com(若此前使用TokenHub接口则需同步改为 https://tokenhub.tencentmaas.com/v1)→ 点击「测试连接」→ 成功后点「确定」。
停用旧Key并验证切换效果
第一步:返回TokenHub「API密钥管理」页面 → 找到旧Key所在行 → 点击「删除」→ 输入二次确认 → 完成销毁。
第二步:在客户端发起一次文本生成请求,观察是否返回正常响应结果。
第三步:若出现 401 Unauthorized 错误,说明新Key未生效或粘贴时混入空格;若返回 404 Not Found,说明API地址未同步更新为TokenHub新域名。


















