LibreChat 설정 가이드

Kitta AI TTS를 LibreChat에 연결합니다.

LibreChat은 librechat.yaml에서 서버측 TTS를 독립적으로 구성할 수 있습니다. 음성 제공자는 채팅 모델 제공자와 별개이므로 Kitta AI를 채팅 엔드포인트로 추가하면 안 됩니다.

시작하기 전에

1. API 관리에서 이 인스턴스 전용 키를 생성합니다.
2. 복제된 음성을 열고 음성 ID를 복사하세요.
3. API 크레딧 잔액이 충분한지 확인하세요.

빠른 테스트를 위해 다음을 사용하세요.

00a1b221-6137-4b73-ad62-b0cbce134167

환경 변수 구성

LibreChat의 .env 파일에 이 변수를 추가합니다:

FISH_AUDIO_API_KEY=YOUR_FISH_AUDIO_API_KEY

librechat.yaml 또는 Git 저장소에서 직접 실제 키를 커밋하지 마세요.

librechat.yaml 구성

이 구성을 기존 speech 개체에 병합하고 테스트 음성을 자신의 음성 ID로 바꿉니다.

speech:
  tts:
    openai:
      url: 'https://kittaai.com/v1/audio/speech'
      apiKey: '${FISH_AUDIO_API_KEY}'
      model: 'fishaudio-s21pro-flash'
      voices:
        - '00a1b221-6137-4b73-ad62-b0cbce134167'
  speechTab:
    textToSpeech:
      engineTTS: 'external'
      voice: '00a1b221-6137-4b73-ad62-b0cbce134167'
      automaticPlayback: false

여러 음성을 제공하려면 모든 음성 ID를 voices 배열에 추가하세요. LibreChat 사용자는 관리자가 허용한 음성 중에서 선택할 수 있습니다.

구성을 저장한 후 LibreChat을 다시 시작하십시오.

docker compose restart

LibreChat의 음성 설정을 열고 외부 TTS 및 구성된 음성 ID를 선택하고 테스트로 짧은 응답을 재생합니다.

문제 해결

• 외부 TTS가 누락되었습니다: speechTab.textToSpeech.engineTTS를 external로 설정하고 LibreChat을 다시 시작하세요.
• 음성이 누락되었습니다: 음성 ID는 voices 배열에도 나타나야 합니다. 구성을 편집한 후 다시 로드하십시오.
• 404: url는 완전한 https://kittaai.com/v1/audio/speech URL이어야 합니다.
• 401: 컨테이너가 FISH_AUDIO_API_KEY를 수신하고 키가 유효한지 확인합니다.
• 402: 다시 시도하기 전에 API 크레딧을 추가하세요.
• 400: tts-1를 사용하지 마세요. 모델을 fishaudio-s21pro-flash로 설정하고 유효한 음성 ID를 사용하세요.
• 채팅 요청 실패: LibreChat 채팅 사용자 정의 엔드포인트에 Kitta AI URL을 입력하지 마세요. 이 설정에서는 TTS 전용 엔드포인트입니다.

관련 문서

• OpenAI-호환 TTS
• 음성 ID 받기
• 리브레챗 음성 구성