Kitta AI Docs
Guias de integraçãoIntegrações de terceiros
Back to site

Guia de configuração do LibreChat

Configure Kitta AI como um provedor TTS do lado do servidor compatível com OpenAI em librechat.yaml e reproduza respostas com uma voz clonada.

Conecte Kitta AI TTS ao LibreChat

LibreChat pode configurar TTS do lado do servidor de forma independente em librechat.yaml. Seu provedor de fala é separado de seus provedores de modelo de bate-papo, portanto, Kitta AI não deve ser adicionado como ponto de extremidade de bate-papo.

Antes de começar

  1. Crie uma chave dedicada a esta instância em Gerenciamento API.
  2. Abra sua voz clonada e copie seu ID de voz.
  3. Confirme se seu saldo de crédito API é suficiente.

Para um teste rápido, use:

00a1b221-6137-4b73-ad62-b0cbce134167

Configure a variável de ambiente

Adicione esta variável ao arquivo .env do LibreChat:

FISH_AUDIO_API_KEY=YOUR_FISH_AUDIO_API_KEY

Não confirme a chave real diretamente em librechat.yaml ou em seu repositório Git.

Configurar librechat.yaml

Mescle esta configuração no objeto speech existente e substitua a voz de teste pelo seu próprio ID de voz:

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

url is the complete request URL

O LibreChat solicita speech.tts.openai.url diretamente, portanto deve incluir /audio/speech. Esse difere dos aplicativos que solicitam apenas um URL base.

Para oferecer diversas vozes, adicione cada ID de voz ao array voices. Os usuários do LibreChat podem selecionar entre as vozes permitidas pelo administrador.

Reinicie o LibreChat após salvar a configuração:

docker compose restart

Abra as configurações de fala do LibreChat, selecione TTS externo e o ID de voz configurado e reproduza uma resposta curta como teste.

Solução de problemas

  • TTS externo está faltando: defina speechTab.textToSpeech.engineTTS como external e reinicie o LibreChat.
  • Falta a voz: o ID da voz também deve aparecer no array voices. Recarregue a configuração após editá-la.
  • 404: url deve ser o URL https://kittaai.com/v1/audio/speech completo.
  • 401: verifique se o container recebe FISH_AUDIO_API_KEY e se a chave é válida.
  • 402: adicione créditos API antes de tentar novamente.
  • 400: não use tts-1. Defina o modelo como fishaudio-s21pro-flash e use um ID de voz válido.
  • Falha nas solicitações de bate-papo: não coloque o URL Kitta AI em um endpoint personalizado de bate-papo do LibreChat. É um endpoint somente TTS nesta configuração.

Documentação relacionada