必须用实名认证的腾讯云主账号登录TokenHub创建混元API Key,子账号无权限;开通服务后进入API密钥管理创建Key,名称需含用途与日期,访问范围须全选;Secret Key仅显示一次,须立即复制保存;验证方式为curl测试返回200或控制台状态显示“正常”且有调用记录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 TokenHub 上创建腾讯混元 API Key,必须使用已通过实名认证的腾讯云主账号登录,子账号默认无创建权限,且密钥一旦删除将【无法恢复】,务必在创建后立即复制保存。
登录并开通 TokenHub 服务
访问 TokenHub 控制台 → 使用主账号登录 → 若首次进入,页面会提示「开通服务」,点击立即开通 → 等待服务状态变为「已启用」(通常秒级完成)。
创建 API Key
左侧导航栏点击「API 密钥管理」→ 点击右上角「创建 API Key」按钮 → 在弹窗中填写 Key 名称(建议含用途与日期,如“WorkBuddy-Hunyuan-202609”)→ 访问范围务必勾选「全选」(否则后续调用混元以外模型会失败)→ 点击「确定」。
弹出密钥详情页后,【立即复制 Secret Key】(仅显示一次,关闭页面即永久丢失)→ 将其粘贴至本地加密文档或密码管理器中保存。
验证密钥有效性
方法一:直接 curl 测试
在终端执行:
curl -X POST 'https://tokenhub.tencentmaas.com/v1/chat/completions' \<br>
-H 'Content-Type: application/json' \<br>
-H 'Authorization: Bearer YOUR_API_KEY' \<br>
-d '{ "model": "hy4-preview", "messages": [{"role": "user", "content": "测试"}], "temperature": 0.1 }'把 YOUR_API_KEY 替换为你刚复制的密钥,返回 200 且含 content 字段即成功。
方法二:在 TokenHub 控制台「API 密钥管理」列表中,找到该 Key 对应行,状态列显示「正常」且「最近调用时间」有更新记录。


















