統合ガイドサードパーティの統合
ホームアシスタントのセットアップ
HACS OpenAI TTS カスタム エンドポイントを使用して、ホーム アシスタントで Kitta Audio アナウンスと音声アシスタント応答を作成します。
Kitta Audio TTS をホームアシスタントに接続します
このガイドでは、カスタム OpenAI 互換エンドポイントをサポートする HACS OpenAI TTS 統合を使用します。 Kitta Audio 音声をホーム アシスタント メディア プレーヤーに送信して、アナウンス、自動化、アシストを行います。
Choose the correct integration
組み込みの OpenAI 会話統合は、サードパーティの TTS ベース URL を提供しません。これ
ガイドでは、代わりに sfortis/openai_tts HACS 統合を使用します。
統合をインストールする
- HACS を開き、OpenAI TTS の統合を検索します。
- ダウンロードしてホームアシスタントを再起動します。
Settings → Devices & Services → Add Integration → OpenAI TTSを開きます。- Kitta Audio API キーとカスタム エンドポイント
https://fishaudio.org/v1を入力します。
以下を使用して TTS エージェントを追加します。
| 設定 | 値 |
|---|---|
| モデル | fishaudio-s21pro-flash |
| 声 | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| 音声フォーマット | mp3 |
| スピード | 1 |
カスタム エンドポイント モードは、手動で入力された Kitta Audio 音声 ID を受け入れます。最初の成功アナウンス後にテスト音声を置き換えます。
アナウンスをテストする
開発者ツールから統合の openai_tts.say アクションを呼び出します。
action: openai_tts.say
target:
entity_id: media_player.living_room_speaker
data:
tts_entity: tts.openai_tts_fish_audio
message: 'Hello, this is a Kitta Audio smart-home announcement.'
volume: 0.6両方のエンティティ ID を実際の TTS エージェントとメディア プレーヤーに置き換えます。機能したら、そのアクションをドアベル、アラート、天気予報、またはカレンダーの自動化で再利用します。
トラブルシューティング
- カスタム エンドポイント フィールドなし: 組み込みの OpenAI 会話ではなく、HACS OpenAI TTS 統合がインストールされていることを確認してください。
- スピーカーは静かです:
media_playerが通常のメディアを再生し、ホーム アシスタントのログを検査できることを確認します。 - Kitta Audio 音声はリストにありません: カスタム エンドポイント モードで音声 ID を手動で入力します。
- 401/402: API キーと API クレジット残高を確認します。