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

ホームアシスタントのセットアップ

HACS OpenAI TTS カスタム エンドポイントを使用して、ホーム アシスタントで Fish Audio アナウンスと音声アシスタント応答を作成します。

Fish Audio TTS をホームアシスタントに接続します

このガイドでは、カスタム OpenAI 互換エンドポイントをサポートする HACS OpenAI TTS 統合を使用します。 Fish Audio 音声をホーム アシスタント メディア プレーヤーに送信して、アナウンス、自動化、アシストを行います。

Choose the correct integration

組み込みの OpenAI 会話統合は、サードパーティの TTS ベース URL を提供しません。これ ガイドでは、代わりに sfortis/openai_tts HACS 統合を使用します。

統合をインストールする

  1. HACS を開き、OpenAI TTS の統合を検索します。
  2. ダウンロードしてホームアシスタントを再起動します。
  3. Settings → Devices & Services → Add Integration → OpenAI TTS を開きます。
  4. Fish Audio API キーとカスタム エンドポイント https://fishaudio.org/v1 を入力します。

以下を使用して TTS エージェントを追加します。

設定
モデルfishaudio-s21pro-flash
00a1b221-6137-4b73-ad62-b0cbce134167
音声フォーマットmp3
スピード1

カスタム エンドポイント モードは、手動で入力された Fish 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 Fish Audio smart-home announcement.'
  volume: 0.6

両方のエンティティ ID を実際の TTS エージェントとメディア プレーヤーに置き換えます。機能したら、そのアクションをドアベル、アラート、天気予報、またはカレンダーの自動化で再利用します。

トラブルシューティング

  • カスタム エンドポイント フィールドなし: 組み込みの OpenAI 会話ではなく、HACS OpenAI TTS 統合がインストールされていることを確認してください。
  • スピーカーは静かです: media_player が通常のメディアを再生し、ホーム アシスタントのログを検査できることを確認します。
  • Fish Audio 音声はリストにありません: カスタム エンドポイント モードで音声 ID を手動で入力します。
  • 401/402: API キーと API クレジット残高を確認します。

関連ドキュメント