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
- Öffnen Sie HACS und suchen Sie nach Integrationen nach OpenAI TTS.
- Laden Sie es herunter und starten Sie Home Assistant neu.
- Öffnen Sie
Settings → Devices & Services → Add Integration → OpenAI TTS. - Geben Sie Ihren Schlüssel Fish Audio API und den benutzerdefinierten Endpunkt
https://fishaudio.org/v1ein.
Fügen Sie einen TTS-Agenten hinzu mit:
| Einstellung | Wert |
|---|---|
| Modell | fishaudio-s21pro-flash |
| Stimme | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| Audioformat | mp3 |
| Geschwindigkeit | 1 |
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.6Ersetzen 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_playernormale 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
OpenClaw-Setup
Verwenden Sie den OpenClaw OpenAI TTS-Anbieter mit Fish Audio für Sprachantworten auf Telegram, WhatsApp und anderen Kanälen.
ChatticaAI-Setup
Verwenden Sie die Fish Audio- oder OpenAI-kompatible TTS-Option in ChatticaAI, um eine API-Taste, ein Modell und eine Zeichenstimme zu konfigurieren.