旧平台API Key无法在TokenHub使用，因其认证体系完全隔离，旧Key请求均返回401；新Key需通过个人开通或企业工单获取，且有效期仅2个月，调用时须用open.hunyuan.tencent.com域名及正确48位sk-开头Token。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元旧平台（即原MaaS平台）生成的API Key无法直接在TokenHub使用，因为TokenHub是2026年3月27日全新升级的独立服务平台，其认证体系与旧平台完全隔离。
确认旧Key是否失效
登录原MaaS控制台 → 进入「API密钥管理」页面 → 查看密钥状态栏是否显示「已停用」或「仅限历史调用」。若显示「已迁移至TokenHub」，说明该Key已被系统自动作废。
旧平台API Key的域名前缀为 api.maaS.tencent.com，而TokenHub强制要求使用 open.hunyuan.tencent.com 域名，请求头中 Authorization 字段校验逻辑也已重构，【旧Key发起的任何请求均会返回401 Unauthorized】。
获取TokenHub可用的新API Key
方法一：个人用户快速开通
访问 腾讯云混元套餐页 → 使用同一手机号登录 → 点击「立即开通TokenHub服务」→ 完成实名认证 → 在「API密钥管理」中创建新Key。
方法二：企业用户批量迁移
联系腾讯云客户经理提交《MaaS存量Key迁移工单》→ 提供旧平台AppID与主账号UID → 等待后台人工核验（通常2个工作日内完成）→ 收到邮件通知后，在TokenHub控制台「企业凭证」页签下载新Key包。
注意：新Key默认有效期为2个月，与旧平台Key的永久有效机制不同，需提前配置自动轮换脚本。
验证新Key能否调用Hy3/Hy4preview模型
第一步：打开Postman或curl终端
第二步：构造POST请求，URL填 https://open.hunyuan.tencent.com/openapi/v1/chat/completions
第三步：在Headers中添加 Authorization: Bearer <你的新Token> 和 Content-Type: application/json
第四步：Body选raw → JSON，输入最小化测试体：
{
"model": "hy3",
"messages": [{"role": "user", "content": "你好"}]
}
发送后若返回200及含"choices"字段的JSON响应，说明新Key已生效。若返回"error": {"code": "InvalidApiKey"}，请检查Token是否复制完整——【Token开头为sk-xxx且长度必须为48位，缺一位都会失败】。
