集成指南第三方软件接入
Home Assistant 接入教程
通过 HACS OpenAI TTS 自定义 Endpoint 在 Home Assistant 中使用 Kitta Audio 音色进行自动播报。
Home Assistant 接入 Kitta Audio TTS
本教程使用 HACS 中支持自定义 OpenAI 兼容 Endpoint 的 OpenAI TTS 集成。它可以把 Kitta Audio 语音发送到 Home Assistant 的媒体播放器，用于通知、自动化和 Assist。
不要选择错误的集成
Home Assistant 内置 OpenAI Conversation 不提供第三方 TTS Base URL。本教程使用 HACS 的
sfortis/openai_tts 自定义集成，而不是内置 OpenAI Conversation。
安装集成
- 打开 HACS，在 Integrations 中搜索 OpenAI TTS；
- 下载后重启 Home Assistant；
- 进入
Settings → Devices & Services → Add Integration → OpenAI TTS； - 填写 Kitta Audio API Key 和自定义 Endpoint
https://fishaudio.org/v1。
为集成添加 TTS Agent，填写：
| 配置项 | 值 |
|---|---|
| Model | fishaudio-s21pro-flash |
| Voice | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| Audio format | mp3 |
| Speed | 1 |
自定义 Endpoint 模式允许手动输入 Kitta Audio 音色 ID。首次测试后再替换为自己的音色。
测试播报
在 Developer Tools 中调用集成提供的 openai_tts.say Action：
action: openai_tts.say
target:
entity_id: media_player.living_room_speaker
data:
tts_entity: tts.openai_tts_fish_audio
message: '你好，这是一条 Kitta Audio 智能家居播报。'
volume: 0.6把示例中的实体 ID 替换为实际 TTS Agent 和播放器实体。测试成功后可将 Action 放入门铃、告警、天气或日程自动化。
常见问题
- 找不到自定义 Endpoint：确认安装的是 HACS OpenAI TTS，而不是内置 OpenAI Conversation。
- 播放器没有声音：先确认该
media_player能播放普通媒体，并检查 Home Assistant 日志。 - 音色下拉列表没有 Kitta Audio 音色：在自定义 Endpoint 模式手动填写音色 ID。
- 401/402：检查集成中的 API Key 和 API 积分。