Kitta Audio TTS를 OpenCrab에 연결합니다.

OpenCrabs는 모든 /v1/audio/speech 호환 엔드포인트를 지원하며 에이전트 응답을 Telegram, WhatsApp, Discord 또는 Slack의 음성 메시지로 전환할 수 있습니다.

TTS 구성

config.toml 편집:

[voice]
tts_enabled = true
tts_mode = "openai_compatible"
tts_base_url = "https://fishaudio.org/v1"
tts_model = "fishaudio-s21pro-flash"
tts_voice = "00a1b221-6137-4b73-ad62-b0cbce134167"

keys.toml에 API 키를 저장합니다.

[providers.tts.openai_compatible]
api_key = "YOUR_API_KEY"

keys.toml를 공개 저장소에 커밋하지 마세요. /onboard:voice를 실행하고 OpenAI 호환을 선택하고 동일한 URL, 모델 및 음성을 대화식으로 입력할 수도 있습니다.

연결 테스트

OpenCrabs를 다시 시작하고 연결된 채널을 통해 짧은 응답을 트리거합니다. 오디오가 재생된 후 테스트 음성을 원하는 음성 ID로 바꿉니다.

OpenCrabs는 각 메시징 채널의 오디오 인코딩을 처리합니다. 먼저 오디오 파일이 재생되는지 확인한 다음 채널에 해당 파일이 기본 음성 풍선으로 표시되는지 확인하세요.

문제 해결

• 404 엔드포인트: 기본 URL은 문서 페이지 URL이 아닌 https://fishaudio.org/v1입니다.
• 로컬 파이퍼가 계속 사용됩니다: tts_mode를 openai_compatible로 설정합니다.
• 음성이 생성되지 않습니다: tts_enabled = true를 확인하고 채널이 오디오 첨부를 허용하는지 확인하세요.
• 401/402: keys.toml의 키와 API 크레딧 잔액을 확인합니다.

관련 문서

• OpenAI-호환 TTS
• API 오류
• 공식 OpenCrabs 음성 안내