Fish Audio TTS를 홈어시스턴트에 연결

이 가이드에서는 사용자 지정 OpenAI 호환 엔드포인트를 지원하는 HACS OpenAI TTS 통합을 사용합니다. 공지, 자동화 및 지원을 위해 Fish Audio 음성을 Home Assistant 미디어 플레이어에 보냅니다.

통합 설치

1. HACS를 열고 OpenAI TTS에 대한 통합을 검색합니다.
2. 다운로드하고 홈어시스턴트를 다시 시작하세요.
3. Settings → Devices & Services → Add Integration → OpenAI TTS를 엽니다.
4. Fish Audio API 키와 사용자 지정 엔드포인트 https://fishaudio.org/v1를 입력합니다.

다음을 사용하여 TTS 에이전트를 추가합니다.

사용자 정의 엔드포인트 모드에서는 수동으로 입력된 Fish 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 Fish Audio smart-home announcement.'
  volume: 0.6

두 엔터티 ID를 실제 TTS 에이전트 및 미디어 플레이어로 바꿉니다. 작동한 후에는 초인종, 알림, 날씨 또는 캘린더 자동화에서 작업을 재사용하세요.

문제 해결

• 사용자 정의 엔드포인트 필드 없음: 기본 제공 OpenAI 대화가 아닌 HACS OpenAI TTS 통합을 설치했는지 확인하세요.
• 스피커가 조용합니다: media_player가 일반 미디어를 재생할 수 있는지 확인하고 홈어시스턴트 로그를 검사합니다.
• Fish Audio 음성은 나열되지 않습니다: 사용자 정의 엔드포인트 모드에서 음성 ID를 수동으로 입력합니다.
• 401/402: API 키와 API 크레딧 잔액을 확인합니다.

관련 문서

• API 가격
• 음성ID 찾기
• HACS OpenAI TTS 프로젝트
• 공식 홈어시스턴트 Fish Audio 통합