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>
This commit is contained in:
yuanzonghao
2026-06-04 20:40:59 +08:00
parent 4be980d8ee
commit e6d60999ac
+45 -39
View File
@@ -1,7 +1,7 @@
# 自带配音 Key 教程(小米 MiMo TTS
InfiPlot 的角色配音由小米 **MiMo-V2.5-TTS** 模型实时合成。本页教你免费申请一个属于自己的 API Key,
InfiPlot 后即可获得**稳定的配音更低的延迟**——而且这个 Key **只存在你的浏览器里,绝不会经过我们的服务器**
InfiPlot 的角色配音由小米 **MiMo-V2.5-TTS** 模型实时合成。按照本教程,你可以免费申请一个属于自己的 API Key,
InfiPlot 后即可获得**稳定的配音更低的延迟**——而且这个 Key **只存在你的浏览器里,绝不会经过我们的服务器**
> 本教程随仓库维护,链接长期有效。
@@ -9,49 +9,55 @@ InfiPlot 的角色配音由小米 **MiMo-V2.5-TTS** 模型实时合成。本页
## 为什么需要自带 Key
InfiPlot 默认用一**公共的服务器 Key** 所有配音。小米对语音模型 **RPM(每分钟请求数)/ TPM(每分钟 Token 数)** 做了限额,而且这个额度并不高。当很多人**同时**游玩时,公共 Key 很容易撞到限额,结果就是——
InfiPlot 默认使用一**公共 Key** 所有用户提供配音。小米对语音模型设有 **RPM(每分钟请求数)/ TPM(每分钟 Token 数)** 的调用限额,而公共 Key 的额度由全部用户共享。当同时在线的人较多时,公共 Key 很容易达到上限,表现为——
- 剧情画面都正常,**唯独没有声音**(静音);
- 或者配音偶尔断断续续、要等很久
- 剧情画面都正常,**唯独没有声音**(静音);
- 或者配音断断续续、要等待较长时间
填入你**自己的**免费 Key 后,你用的是自己独立的额度,不再其他人抢,于是
填入你**自己的** Key 后,你将使用独立的额度,不再其他用户的影响
-**配音稳定**,不再随机静音;
-**延迟更低**就近区域,少一跳);
-**完全免费**——MiMo-V2.5-TTS 目前限时 **0x 计费**,不消耗套餐额度。
-**配音稳定**,不再出现随机静音;
-**延迟更低**套餐 Key 还可以选择就近区域节点);
-**完全免费**——MiMo-V2.5-TTS 目前限时**免费**,不消耗套餐额度。
这是一个**可选增强**。不填也能正常玩,只是高峰期更容易遇到静音。
这是一个**可选增强功能**。不填也能正常玩,只是高峰期更容易遇到静音。
---
## 一、免费申请 API Key
1. 打开小米 MiMo 开放平台并注册 / 登录:<https://platform.xiaomimimo.com>
- 注册即可领取免费额度(Token Plan)。
2. 进入**控制台 → 套餐管理**<https://platform.xiaomimimo.com/console/plan-manage>
3. 在该页面找到并**复制你的专属 API Key**。
- 套餐 Key 形如 `tp-xxxxxxxx`;按量 Key 形如 `sk-xxxxxxxx`。两者相互独立、不能混用,**任选一个有效的即可**。
- 妥善保管,**不要公开分享**这把 Key。
> MiMo-V2.5-TTS 系列当前为限时 **0x 计费**(不消耗套餐 Credits),所以配音这件事基本是免费的。具体以平台公告为准。
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 类型(套餐需额外选区域)
小米有**两类 Key**,对应不同的端点。在 InfiPlot 里**先选类型**—— Key 前缀就能判断:`tp-`套餐`sk-`按量,两者不能混用。
小米有**两类 Key**分别对应不同的服务地址。在 InfiPlot 中填写时需要**先选择 Key 类型**——通过 Key 前缀即可判断:`sk-`按量付费`tp-`套餐,两者不能混用。
**套餐 Token Plan`tp-` 开头)** —— 再选一个**区域节点**,对应小米不同地区的 Token Plan:
**按量付费 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` |
选**离你最近**、且**与你套餐订阅区一致**的那个——延迟最低、最不容易出错。一般跟着你注册时的区域走即可
**② 按量付费 Pay-as-you-go`sk-` 开头)** —— 使用统一端点 `https://api.xiaomimimo.com/v1`**无需选择区域**。
请选择**与你套餐订阅区一致**的节点(通常也是离你最近、延迟最低的那个)
---
@@ -59,41 +65,41 @@ InfiPlot 默认用一把**公共的服务器 Key** 给所有人配音。小米
1. 回到 InfiPlot **首页**,在选项区下方点击 **「经常没声音?自带配音 Key(可选)」**。
2. 在弹窗里:
- **选择 Key 类型**套餐 / 按量);选「套餐」时**选区域**,选「按量」则无需选区域;
- **选择 Key 类型**按量付费 / 套餐);选「套餐」时需要额外**选区域**,选「按量付费」则无需选区域;
- **粘贴你的 API Key**
3. 点击 **「保存并启用」**。按钮会变 **「自带配音 Key · 已启用」**,「语音配音」也会自动切「开启」。
4. 开始游玩——配音将由你的浏览器**直连小米**完成。
3. 点击 **「保存并启用」**。按钮会变 **「自带配音 Key · 已启用」**,「语音配音」也会自动切换为「开启」。
4. 开始游玩——配音将由你的浏览器**直接连接小米服务**完成。
想停用时,再次打开弹窗点击 **「停用并清除」** 即可,本地保存的 Key 会一并删除。
想停用时,再次打开弹窗点击 **「停用并清除」** 即可,本地保存的 Key 会一并删除。
---
## 四、隐私说明
- 你的 API Key **只保存在当前浏览器的 `localStorage`**(键名 `infiplot:tts`
- 启用后,配音请求由**你的浏览器直接发小米**对应的端点,携带你的 Key。
- 你的 API Key **只保存在当前浏览器的 `localStorage`**(键名 `infiplot:tts`
- 启用后,配音请求由**你的浏览器直接发送至小米**对应的服务地址,携带你的 Key。
- 我们的服务器**完全不参与**这条链路,**既看不到也不会记录**你的 Key。
- 换设备 / 换浏览器 / 清缓存后需要重新填写,这是预期行为。
- 换设备、更换浏览器或清除缓存后需要重新填写,这是预期行为。
---
## 五、常见问题
**Q:填了 Key 还是没声音?**
- 确认「语音配音」「开启」状态;
- 确认 **Key 类型选对了**`tp-` 选「套餐」、`sk-` 选「按量付费」,选错端点会一直失败;
- 确认 Key 没填错、没多余空格,且仍有额度;
- 套餐 Key 可换一个**区域**试试(区域与订阅地不匹配也可能失败);
- 打开浏览器开发者工具的 Network 面板,看对 `*.xiaomimimo.com` 的请求返回了什么错误。
- 确认「语音配音」处于「开启」状态;
- 确认 **Key 类型选对了**`sk-` 选「按量付费」、`tp-` 选「套餐」,类型选错会导致鉴权失败;
- 确认 Key 没填错或包含多余空格,且仍有可用额度;
- 使用套餐 Key 时,可以尝试切换**区域**(区域与订阅地不匹配也可能导致失败);
- 打开浏览器开发者工具的 Network 面板,看对 `*.xiaomimimo.com` 的请求返回了什么错误。
**Q:会产生费用吗?**
- MiMo-V2.5-TTS 当前限时 0x 计费,正常游玩配音不消耗套餐额度。最终以小米平台的计费公告为准。
- MiMo-V2.5-TTS 当前限时费,正常游玩配音不消耗套餐额度。最终以小米平台的计费公告为准。
**Q`tp-` 和 `sk-` 用哪个?**
- 看你手里是哪种 Key 就选哪种类型——`tp-` 选「套餐 Token Plan」、`sk-` 选「按量付费」。两者不能混用,选错端点会鉴权失败。
**Q`sk-` 和 `tp-` 用哪个?**
- 推荐使用 `sk-`(按量付费),注册后即可使用,无需购买套餐。如果你已有 Token Plan 套餐,也可以使用 `tp-`(套餐 Key。两者不能混用,类型选错会导致鉴权失败。
**Q:我的 Key 安全吗?**
- 安全。只存在你本地浏览器、只发给小米官方端点,不经过 InfiPlot 服务器。但请勿把 Key 贴到公开场合或分享给他人。
- 安全。Key 只存在你本地浏览器中,只会发送至小米官方服务地址,不经过 InfiPlot 服务器。但请不要将 Key 公开发布或分享给他人。
---