Configuração do assistente doméstico
Use um endpoint personalizado HACS OpenAI TTS para criar anúncios Kitta Audio e respostas do assistente de voz no Home Assistant.
Conecte Kitta Audio TTS ao Home Assistant
Este guia usa a integração HACS OpenAI TTS que suporta terminais customizados compatíveis com OpenAI. Ele envia fala Kitta Audio para reprodutores de mídia Home Assistant para anúncios, automações e assistência.
Choose the correct integration
A integração integrada do OpenAI Conversation não fornece um URL base TTS de terceiros. Esse O
guia usa a integração sfortis/openai_tts HACS.
Instale a integração
- Abra o HACS e procure Integrações por OpenAI TTS.
- Baixe e reinicie o Home Assistant.
- Abra
Settings → Devices & Services → Add Integration → OpenAI TTS. - Insira sua chave Kitta Audio API e o endpoint personalizado
https://fishaudio.org/v1.
Adicione um agente TTS com:
| Configuração | Valor |
|---|---|
| Modelo | fishaudio-s21pro-flash |
| Voz | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| Formato de áudio | mp3 |
| Velocidade | 1 |
O modo de endpoint personalizado aceita um ID de voz Kitta Audio inserido manualmente. Substitua a voz de teste após o primeiro anúncio bem-sucedido.
Teste um anúncio
Chame a ação openai_tts.say da integração nas Ferramentas do desenvolvedor:
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.6Substitua ambos os IDs de entidade pelo seu agente TTS e reprodutor de mídia reais. Depois de funcionar, reutilize a ação em automações de campainha, alerta, previsão do tempo ou calendário.
Solução de problemas
- Nenhum campo de endpoint personalizado: certifique-se de ter instalado a integração HACS OpenAI TTS, não o OpenAI Conversation integrado.
- O alto-falante está silencioso: confirme se o
media_playerpode reproduzir mídia normal e inspecionar os registros do Home Assistant. - As vozes Kitta Audio não estão listadas: insira manualmente o ID de voz no modo de endpoint personalizado.
- 401/402: verifique a chave API e o saldo de crédito API.