통합 가이드타사 통합
홈어시스턴트 설정
HACS OpenAI TTS 사용자 정의 엔드포인트를 사용하여 홈어시스턴트에서 Kitta Audio 공지 및 음성 지원 응답을 생성합니다.
Kitta Audio TTS를 홈어시스턴트에 연결
이 가이드에서는 사용자 지정 OpenAI 호환 엔드포인트를 지원하는 HACS OpenAI TTS 통합을 사용합니다. 공지, 자동화 및 지원을 위해 Kitta Audio 음성을 Home Assistant 미디어 플레이어에 보냅니다.
Choose the correct integration
내장된 OpenAI 대화 통합은 타사 TTS 기본 URL을 제공하지 않습니다. 이것 가이드는 대신
sfortis/openai_tts HACS 통합을 사용합니다.
통합 설치
- HACS를 열고 OpenAI TTS에 대한 통합을 검색합니다.
- 다운로드하고 홈어시스턴트를 다시 시작하세요.
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 에이전트 및 미디어 플레이어로 바꿉니다. 작동한 후에는 초인종, 알림, 날씨 또는 캘린더 자동화에서 작업을 재사용하세요.
문제 해결
- 사용자 정의 엔드포인트 필드 없음: 기본 제공 OpenAI 대화가 아닌 HACS OpenAI TTS 통합을 설치했는지 확인하세요.
- 스피커가 조용합니다:
media_player가 일반 미디어를 재생할 수 있는지 확인하고 홈어시스턴트 로그를 검사합니다. - Kitta Audio 음성은 나열되지 않습니다: 사용자 정의 엔드포인트 모드에서 음성 ID를 수동으로 입력합니다.
- 401/402: API 키와 API 크레딧 잔액을 확인합니다.