Fish Audio Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

Home Assistant-Setup

Verwenden Sie einen benutzerdefinierten HACS-Endpunkt OpenAI TTS, um Fish Audio-Ankündigungen und Sprachassistent-Antworten in Home Assistant zu erstellen.

Verbinden Sie Fish Audio TTS mit Home Assistant

In diesem Handbuch wird die HACS-Integration OpenAI TTS verwendet, die benutzerdefinierte OpenAI-kompatible Endpunkte unterstützt. Es sendet Fish Audio-Sprache an Home Assistant-Mediaplayer für Ankündigungen, Automatisierungen und Assist.

Choose the correct integration

Die integrierte OpenAI-Konversationsintegration stellt keine TTS-Basis-URL eines Drittanbieters bereit. Das Der Leitfaden verwendet stattdessen die sfortis/openai_tts HACS-Integration.

Installieren Sie die Integration

  1. Öffnen Sie HACS und suchen Sie nach Integrationen nach OpenAI TTS.
  2. Laden Sie es herunter und starten Sie Home Assistant neu.
  3. Öffnen Sie Settings → Devices & Services → Add Integration → OpenAI TTS.
  4. Geben Sie Ihren Schlüssel Fish Audio API und den benutzerdefinierten Endpunkt https://fishaudio.org/v1 ein.

Fügen Sie einen TTS-Agenten hinzu mit:

EinstellungWert
Modellfishaudio-s21pro-flash
Stimme00a1b221-6137-4b73-ad62-b0cbce134167
Audioformatmp3
Geschwindigkeit1

Der benutzerdefinierte Endpunktmodus akzeptiert eine manuell eingegebene Fish Audio-Sprach-ID. Ersetzen Sie die Teststimme nach der ersten erfolgreichen Ansage.

Testen Sie eine Ansage

Rufen Sie die openai_tts.say-Aktion der Integration über die Entwicklertools auf:

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

Ersetzen Sie beide Entitäts-IDs durch Ihren tatsächlichen TTS-Agenten und Mediaplayer. Sobald es funktioniert, können Sie die Aktion in Türklingel-, Alarm-, Wetter- oder Kalenderautomatisierungen wiederverwenden.

Fehlerbehebung

  • Kein benutzerdefiniertes Endpunktfeld: Stellen Sie sicher, dass Sie die HACS-Integration OpenAI TTS und nicht die integrierte OpenAI-Konversation installiert haben.
  • Der Lautsprecher ist stumm: Stellen Sie sicher, dass der media_player normale Medien abspielen kann, und überprüfen Sie die Home Assistant-Protokolle.
  • Fish Audio-Stimmen werden nicht aufgeführt: Geben Sie die Sprach-ID manuell im benutzerdefinierten Endpunktmodus ein.
  • 401/402: Überprüfen Sie den API-Schlüssel und das API-Guthaben.

Verwandte Dokumentation