整合指南第三方集成
家庭助理設置
使用 HACS OpenAI TTS 自訂端點在 Home Assistant 中建立 Kitta Audio 公告和語音助理回應。
將 Kitta Audio TTS 連接到 Home Assistant
本指南使用支援自訂 OpenAI 相容端點的 HACS OpenAI TTS 整合。它向 Home Assistant 媒體播放器發送 Kitta Audio 語音以進行公告、自動化和協助。
Choose the correct integration
內建 OpenAI 對話整合不提供第三方 TTS 基本 URL。這 指南改用 sfortis/openai_tts HACS 整合。
安裝集成
- 開啟 HACS 並蒐索 OpenAI TTS 的整合。2.下載並重啟Home Assistant。3.開啟
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 代理程式和媒體播放器。工作後，在門鈴、警報、天氣或日曆自動化中重複使用該操作。
故障排除
- 無自訂端點欄位：請確保您安裝了 HACS OpenAI TTS 集成，而不是內建的 OpenAI 對話。
- 揚聲器靜音：確認
media_player可以播放常規媒體並檢查 Home Assistant 日誌。 - Kitta Audio 語音未列出：自訂終端模式下手動輸入語音 ID。
- 401/402：驗證API金鑰和API信用餘額。