Conecte Fish 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 Fish Audio para reprodutores de mídia Home Assistant para anúncios, automações e assistência.

Instale a integração

1. Abra o HACS e procure Integrações por OpenAI TTS.
2. Baixe e reinicie o Home Assistant.
3. Abra Settings → Devices & Services → Add Integration → OpenAI TTS.
4. Insira sua chave Fish Audio API e o endpoint personalizado https://fishaudio.org/v1.

Adicione um agente TTS com:

O modo de endpoint personalizado aceita um ID de voz Fish 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 Fish Audio smart-home announcement.'
  volume: 0.6

Substitua 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_player pode reproduzir mídia normal e inspecionar os registros do Home Assistant.
• As vozes Fish 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.

Documentação relacionada

• preço API
• Encontre um ID de voz
• Projeto HACS OpenAI TTS
• Integração oficial do Home Assistant Fish Audio