Files

T

yuanzonghao e6d60999ac docs(tts): prioritize pay-as-you-go path + polish Chinese copy

Rewrite docs/xiaomi-tts-key.md:
- Lead with the sk- (pay-as-you-go) key path as the recommended route,
  since most users don't have a Token Plan subscription.
- Add direct link to the console/api-keys page.
- Polish Chinese prose throughout for natural phrasing and clarity
  (replace jargon like "0x 计费" → "免费", "端点" → "服务地址", etc.).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-06-04 20:40:59 +08:00

5.6 KiB

Raw Blame History

自带配音 Key 教程（小米 MiMo TTS）

InfiPlot 的角色配音由小米 MiMo-V2.5-TTS 模型实时合成。按照本教程，你可以免费申请一个属于自己的 API Key，填入 InfiPlot 后即可获得更稳定的配音和更低的延迟——而且这个 Key 只保存在你的浏览器里，绝不会经过我们的服务器。

本教程随仓库维护，链接长期有效。

为什么需要自带 Key？

InfiPlot 默认使用一个公共 Key 为所有用户提供配音。小米对语音模型设有 RPM（每分钟请求数）/ TPM（每分钟 Token 数） 的调用限额，而公共 Key 的额度由全部用户共享。当同时在线的人较多时，公共 Key 很容易达到上限，表现为——

剧情和画面都正常，唯独没有声音（静音）；
或者配音断断续续、需要等待较长时间。

填入你自己的 Key 后，你将使用独立的额度，不再受其他用户的影响：

✅ 配音稳定，不再出现随机静音；
✅ 延迟更低（套餐 Key 还可以选择就近的区域节点）；
✅ 完全免费——MiMo-V2.5-TTS 目前限时免费，不消耗套餐额度。

这是一个可选的增强功能。不填也能正常游玩，只是高峰期更容易遇到静音。

一、免费申请 API Key

打开小米 MiMo 开放平台并注册 / 登录：https://platform.xiaomimimo.com
推荐：获取按量付费 Key（sk- 开头）
- 进入控制台 → API Keys：https://platform.xiaomimimo.com/console/api-keys
- 在该页面创建或复制你的 API Key（形如 sk-xxxxxxxx）。
- 按量付费 Key 注册后即可使用，无需额外购买套餐，适合大多数用户。
备选：获取套餐 Key（tp- 开头）
- 如果你已经购买了 Token Plan 套餐，可以进入控制台 → 套餐管理：https://platform.xiaomimimo.com/console/plan-manage
- 在该页面复制你的套餐 API Key（形如 tp-xxxxxxxx）。
妥善保管你的 Key，不要公开分享。

MiMo-V2.5-TTS 系列当前限时免费（不消耗套餐 Credits），配音基本不会产生费用。具体以平台公告为准。

二、选择 Key 类型（套餐需额外选区域）

小米有两类 Key，分别对应不同的服务地址。在 InfiPlot 中填写时需要先选择 Key 类型——通过 Key 的前缀即可判断：sk- 是按量付费、tp- 是套餐，两者不能混用。

① 按量付费 Pay-as-you-go（sk- 开头） —— 使用统一服务地址 https://api.xiaomimimo.com/v1，无需选择区域，直接填入 Key 即可。

② 套餐 Token Plan（tp- 开头） —— 需要额外选择一个区域节点，对应小米在不同地区部署的 Token Plan 服务：

区域	说明	服务地址
新加坡 · Singapore	亚太地区推荐	`https://token-plan-sgp.xiaomimimo.com/v1`
中国大陆 · China	中国大陆推荐	`https://token-plan-cn.xiaomimimo.com/v1`
欧洲 · Amsterdam	欧洲推荐	`https://token-plan-ams.xiaomimimo.com/v1`

请选择与你的套餐订阅地区一致的节点（通常也是离你最近、延迟最低的那个）。

三、在 InfiPlot 里填写

回到 InfiPlot 首页，在选项区下方点击 「经常没声音？自带配音 Key（可选）」。
在弹窗里：
- 选择 Key 类型（按量付费 / 套餐）；选「套餐」时需要额外选择区域，选「按量付费」则无需选区域；
- 粘贴你的 API Key；
点击 「保存并启用」。按钮会变为 「自带配音 Key · 已启用」，「语音配音」也会自动切换为「开启」。
开始游玩——配音将由你的浏览器直接连接小米服务完成。

想停用时，再次打开弹窗点击 「停用并清除」 即可，本地保存的 Key 会一并删除。

四、隐私说明

你的 API Key 只保存在当前浏览器的 localStorage（键名 infiplot:tts）中。
启用后，配音请求由你的浏览器直接发送至小米对应的服务地址，携带你的 Key。
我们的服务器完全不参与这条链路，既看不到也不会记录你的 Key。
更换设备、更换浏览器或清除缓存后需要重新填写，这是预期行为。

五、常见问题

Q：填了 Key 还是没声音？

确认「语音配音」处于「开启」状态；
确认 Key 类型选对了：sk- 选「按量付费」、tp- 选「套餐」，类型选错会导致鉴权失败；
确认 Key 没有填错或包含多余空格，且仍有可用额度；
使用套餐 Key 时，可以尝试切换区域（区域与订阅地不匹配也可能导致失败）；
打开浏览器开发者工具的 Network 面板，查看对 *.xiaomimimo.com 的请求返回了什么错误。

Q：会产生费用吗？

MiMo-V2.5-TTS 当前限时免费，正常游玩的配音不会消耗套餐额度。最终以小米平台的计费公告为准。

Q：sk- 和 tp- 用哪个？

推荐使用 sk-（按量付费），注册后即可使用，无需购买套餐。如果你已有 Token Plan 套餐，也可以使用 tp-（套餐 Key）。两者不能混用，类型选错会导致鉴权失败。

Q：我的 Key 安全吗？

安全。Key 只存在你的本地浏览器中，只会发送至小米官方服务地址，不经过 InfiPlot 服务器。但请不要将 Key 公开发布或分享给他人。

有问题欢迎在 GitHub Issues 反馈。

5.6 KiB Raw Blame History Unescape Escape