整合指南第三方集成
RimTalk TTS 設定指南
在 RimWorld 非官方模組 RimTalk TTS 中加入 Fish Audio OpenAI 相容供應商，並為殖民者指定不同音色。
在 RimTalk TTS 中使用 Fish Audio
RimTalk TTS 可透過自訂 OpenAI 相容供應商呼叫 Fish Audio，讓不同 RimWorld 殖民者使用指定音色朗讀對話。
先確認 RimTalk 版本
設定頁必須顯示「自訂 TTS 供應商（未經測試！）」與「新增自訂供應商」。這項功能目前位於上游開發版本；若看不到這些選項，請先確認模組來源與版本。
準備項目
建立一組只供 RimTalk 使用的 API Key，並準備 Fish Audio 音色 ID。不要在公開截圖、聊天或模組檔案中洩露完整 Key；已洩露的 Key 應立即撤銷。
首次測試可使用系統音色：
00a1b221-6137-4b73-ad62-b0cbce134167新增供應商
在 TTS 設定 → 自訂 TTS 供應商 → 新增自訂供應商 填寫：
| 欄位 | 值 |
|---|---|
| 供應商名稱 | Fish Audio |
| 基礎 URL | https://fishaudio.org/v1 |
| 端點路徑 | /audio/speech |
| 模型 | fishaudio-s21pro-flash |
| 預設音色 | 00a1b221-6137-4b73-ad62-b0cbce134167（測試後可更換） |
| 回應格式 | mp3 |
| 認證標頭 | Authorization |
| 認證標頭前綴 | Bearer 後加一個空格 |
| 逾時 | 60 秒 |
完整網址應為 https://fishaudio.org/v1/audio/speech。啟用 speed，關閉 streaming、temperature、top_p、自訂請求本文與額外情緒欄位。
不要使用 tts-1、alloy 或舊供應商的 s2.1-pro。模型 ID 與音色 UUID 是兩個不同欄位。
指定殖民者音色
儲存並選取新的自訂供應商，再到音色模型區新增音色。顯示名稱可自訂，但 Model ID 必須填 Fish Audio 音色 UUID。選擇預設音色後，再為各 Pawn 指定對應音色。
測試與排錯
先讓一名殖民者朗讀一句短文，確認 HTTP 200、MP3 可完整播放，且 API 頁面顯示用量。
- 401：檢查 Key，以及
Bearer後方的空格。 - 402：補充 API 點數。
- 404：基礎 URL 只到
/v1，路徑只填/audio/speech。 - 400：確認模型與音色 UUID 正確。
- 逾時：使用 flash 模型、
60秒逾時與較短文字。 - 429：保留產生冷卻並降低同時請求數。
RimTalk 等待同步音訊，不會輪詢非同步工作；長文字應先縮短。