AstrBot 설정 가이드
AstrBot의 OpenAI TTS Provider를 Kitta Audio에 연결하여 에이전트 응답에 복제 음성을 사용합니다.
Kitta Audio TTS를 AstrBot에 연결하기
AstrBot은 OpenAI 호환 음성 엔드포인트를 통해 Kitta Audio를 호출할 수 있습니다. 설정 후 에이전트의 텍스트 응답을 선택한 복제 음성으로 변환합니다.
AstrBot은 페르소나와 TTS Provider를 별도로 관리합니다. 먼저 Provider를 만든 뒤 기본 설정이나 사용자 지정 규칙에서 대화에 할당하세요.
API Key와 Voice ID 준비
API 관리 페이지에서 API Key를 만들고 복제 음성의 Voice ID를 복사하세요. API 크레딧도 확인해야 합니다. 첫 연결 테스트에는 다음 공개 음성을 사용할 수 있습니다.
00a1b221-6137-4b73-ad62-b0cbce134167TTS Provider 추가
AstrBot 대시보드에서 음성 합성 Provider를 추가하고 OpenAI TTS (API) 를 선택합니다.
| 설정 | 값 |
|---|---|
| API Key | Kitta Audio API Key |
| API Base URL | https://fishaudio.org/v1 |
| Model | fishaudio-s21pro-flash |
| Voice | 복제 음성의 Voice ID |
| Timeout | 60초 권장 |
Base URL은 /v1까지만 입력하세요. AstrBot이 /v1/audio/speech를 자동으로 호출합니다.
FishAudio TTS (API)를 선택하지 마세요
해당 Provider는 다른 네이티브 API와 32자 16진수 reference ID를 사용합니다. fishaudio.org의 복제 음성에는 OpenAI TTS Provider와 플랫폼 Voice ID를 사용하세요.
음성 응답 활성화
AstrBot 설정에서 TTS를 활성화하고 방금 만든 Provider를 선택합니다. 텍스트와 음성을 모두 보내려면 이중 출력을 활성화하세요. 여러 에이전트에 다른 음성을 지정하려면 Voice ID마다 Provider를 만들고 사용자 지정 규칙에서 페르소나와 TTS Provider를 함께 선택합니다.
문제 해결
- Voice가 유효하지 않음: 표시 이름이 아닌 Voice ID를 입력하세요.
- 404:
https://fishaudio.org/v1을 사용하고/audio/speech를 중복하지 마세요. - 401/402: API Key와 별도 API 크레딧 잔액을 확인하세요.
- 잘못된 API 호출: FishAudio TTS (API)가 아니라 OpenAI TTS (API)를 선택하세요.
- 시간 초과: Timeout을
60초로 설정하고 짧은 문장부터 테스트하세요.