腾讯混元:API Key 怎么拿、怎么接进手机写小说

少数把官方角色扮演专模摆上 API 菜单的大厂——hunyuan-role 专为人设对话调教,通用档 a13b 输入 ¥0.5/M 白菜价,角色聊天用户值得配一把。 本页是 腾讯混元 的 BYOK 接入直答:取 Key 分步、控制台与定价页直链、接进 Foreverse 的注意事项。核实于 2026-07-18。

两个入口先放这:取 Key 去 官方控制台,价格查 官方定价页。价格与免费额度随时会调,以官方页面实时为准。

在 Foreverse 里能用它做什么?

预置模板给 腾讯混元 声明了 1 个模态位。实际可用模型以 App 内拉取的该家模型目录为准——各家上新很快,模板标记只代表接入协议已就绪。

模态在 App 里对应
文本续写 · 角色聊天 · Agent

腾讯混元 的 API Key 怎么拿?

  1. 注册腾讯云并完成实名认证(个人或企业均可),登录控制台。
  2. 进入腾讯混元大模型控制台开通服务——首次开通自动发放免费资源包。
  3. 控制台「立即接入」→ 创建 API KEY,复制 sk- 开头的 Key。这是 OpenAI 兼容口的凭证,别和腾讯云的 SecretId/SecretKey 混淆。
  4. 免费包用完不会自动转后付费:去 设置 → 后付费设置 打开开关,否则额度耗尽后调用直接报计费异常。

拿到 Key 之后:接进 Foreverse 三步

  1. 打开 App 的设置 → AI 模型与服务,列表里找到 腾讯混元(62 家预置之一,带 logo 可搜索)。
  2. 粘贴 Key,点「测连通」——发一次真实请求验证密钥与网络,顺手拉回这家的模型列表。
  3. 启用要用的模型,在「默认模型」里按模态分别指定(文本/生图/朗读/视频各设各的);之后续写、聊天、听书就都走这家了。

改 API 地址时的通用坑:地址必须带完整版本前缀(这家该是什么样,下面注意事项里写了),App 不会替你补 /v1。

腾讯混元 专属注意

App 预置 https://api.hunyuan.cloud.tencent.com/v1(OpenAI 兼容,sk- Key)。腾讯正把混元逐步迁往 TokenHub 平台:存量接口继续可用,但新模型只上 TokenHub——TokenHub 的 Key 要把 host 改成 https://tokenhub.tencentmaas.com/v1,Key 与 host 必须同平台。

常见问题

腾讯混元 有免费额度吗?

有:首次开通发一次性免费资源包(Hunyuan-a13b/role/translation/vision 等共享 100 万 tokens,有效期 1 年)。注意耗尽后默认不转后付费,需在设置里手动开通,否则调用报错。

填进 App 的 Key 存在哪里?

系统级加密后只存在你的手机本机,不上传、不同步到 Foreverse 任何服务器;请求从手机直连供应商官方端点,我们不经手也不加价。想撤销就去供应商控制台吊销那把 Key。

腾讯混元 API Key 怎么拿?取 Key 到手机接入全流程(BYOK) · Foreverse · 新梦