AstrBot セットアップガイド
AstrBot の OpenAI TTS Provider から Kitta Audio に接続し、エージェントの応答にクローン音声を使用します。
Kitta Audio TTS を AstrBot に接続する
AstrBot は OpenAI 互換の音声エンドポイントから Kitta Audio を呼び出せます。設定後、エージェントのテキスト応答を選択したクローン音声で再生できます。
AstrBot ではペルソナと TTS Provider が別に管理されます。最初に Provider を作成し、既定設定またはカスタムルールで会話に割り当ててください。
API Key と Voice ID を準備する
API 管理ページで API Key を作成し、クローン音声の Voice ID をコピーします。API クレジットも確認してください。初回テストには次の公開音声を使用できます。
00a1b221-6137-4b73-ad62-b0cbce134167TTS Provider を追加する
AstrBot ダッシュボードで音声合成 Provider を追加し、OpenAI TTS (API) を選択します。
| 設定 | 値 |
|---|---|
| API Key | Kitta Audio API Key |
| API Base URL | https://fishaudio.org/v1 |
| Model | fishaudio-s21pro-flash |
| Voice | クローン音声の Voice ID |
| Timeout | 60 秒を推奨 |
Base URL は /v1 で止めてください。AstrBot が /v1/audio/speech を自動的に追加します。
FishAudio TTS (API) は選択しないでください
この Provider は別のネイティブ API と 32 文字の 16 進 reference ID を使用します。fishaudio.org のクローン音声には OpenAI TTS Provider とプラットフォームの Voice ID を使用してください。
音声応答を有効にする
AstrBot 設定で TTS を有効にして、作成した Provider を選択します。テキストと音声の両方が必要な場合はデュアル出力を有効にします。複数のエージェントで異なる音声を使う場合は Voice ID ごとに Provider を作成し、カスタムルールでペルソナと TTS Provider を指定します。
トラブルシューティング
- Voice が無効：表示名ではなく Voice ID を入力します。
- 404：
https://fishaudio.org/v1を使用し、/audio/speechを重複させないでください。 - 401/402：API Key と個別の API クレジット残高を確認します。
- 別の API が呼ばれる：FishAudio TTS (API) ではなく OpenAI TTS (API) を選択します。
- タイムアウト：Timeout を
60秒にして短い文章からテストします。