Fish Audio Docs
統合ガイドサードパーティの統合
Back to site

RimTalk TTS セットアップガイド

非公式 RimTalk TTS Mod に Fish Audio の OpenAI 互換プロバイダーを追加し、各入植者に異なる音声を割り当てます。

RimTalk TTS で Fish Audio を使用する

RimTalk TTS はカスタム OpenAI 互換プロバイダーから Fish Audio を呼び出し、RimWorld の入植者ごとに指定した音声で会話を読み上げられます。

RimTalk のバージョンを確認してください

設定画面に Custom TTS Providers (Untested!) とプロバイダー追加ボタンが必要です。この機能は現在、上流プロジェクトの開発版にあります。項目がない場合は、まず Mod の入手元とバージョンを確認してください。

準備

RimTalk 専用の API キーと Fish Audio の Voice ID を用意します。完全なキーを公開スクリーンショット、チャット、Mod ファイルに含めないでください。漏えいしたキーは直ちに取り消します。

初回テストでは次のシステム音声を利用できます。

00a1b221-6137-4b73-ad62-b0cbce134167

プロバイダーを追加する

TTS Configuration → Custom TTS Providers → Add New Custom Provider を開き、次を入力します。

項目
Provider nameFish Audio
Base URLhttps://fishaudio.org/v1
Endpoint path/audio/speech
Modelfishaudio-s21pro-flash
Default voice00a1b221-6137-4b73-ad62-b0cbce134167
Response formatmp3
Auth header nameAuthorization
Auth header prefixBearer の後に半角スペースを 1 個
Timeout60

完全な URL は https://fishaudio.org/v1/audio/speech になります。speed を有効にし、streaming、temperature、top_p、感情フィールド、カスタム本文は無効のままにします。

tts-1alloy、旧プロバイダーの s2.1-pro は使用しません。エンジンのモデル ID と音声 UUID は別の値です。

入植者に音声を割り当てる

保存後、新しいカスタムプロバイダーを選択します。音声モデル一覧で表示名を追加し、Model ID に Fish Audio の音声 UUID を貼り付けます。既定音声を選び、各 Pawn に対応する音声を割り当てます。

テストとトラブルシューティング

最初は 1 人の入植者に短い文章を読ませます。HTTP 200、MP3 の完全再生、API 管理画面の使用量を確認してください。

  • 401:キーと Bearer 後のスペースを確認します。
  • 402:API クレジットを追加します。
  • 404:Base URL は /v1 まで、パスは /audio/speech のみです。
  • 400:モデルと音声 UUID を確認します。
  • タイムアウト:flash モデル、60 秒、短い文章を使用します。
  • 429:生成クールダウンを維持し、同時リクエストを減らします。

RimTalk は同期音声レスポンスを待ち、非同期ジョブをポーリングしません。長すぎる入力は短くしてください。

関連ドキュメント