# 自带配音 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

1. 打开小米 MiMo 开放平台并注册 / 登录：<https://platform.xiaomimimo.com>

2. **推荐：获取按量付费 Key（`sk-` 开头）**
   - 进入**控制台 → API Keys**：<https://platform.xiaomimimo.com/console/api-keys>
   - 在该页面创建或复制你的 API Key（形如 `sk-xxxxxxxx`）。
   - 按量付费 Key 注册后即可使用，**无需额外购买套餐**，适合大多数用户。

3. **备选：获取套餐 Key（`tp-` 开头）**
   - 如果你已经购买了 Token Plan 套餐，可以进入**控制台 → 套餐管理**：<https://platform.xiaomimimo.com/console/plan-manage>
   - 在该页面复制你的套餐 API Key（形如 `tp-xxxxxxxx`）。

4. 妥善保管你的 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 里填写

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

想停用时，再次打开弹窗点击 **「停用并清除」** 即可，本地保存的 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](https://github.com/zonghaoyuan/infiplot/issues) 反馈。