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

Guia de configuração do OpenTalking

Configure o provedor TTS compatível com OpenAI no OpenTalking para usar um modelo Kitta AI e voz clonada.

Conecte Kitta AI TTS ao OpenTalking

OpenTalking inclui um provedor openai_compatible TTS para conversas de voz e mídia gerada. Seu provedor TTS é separado de seus provedores LLM e de reconhecimento de fala.

Prepare a chave API e o ID de voz

  1. Crie uma chave dedicada em gerenciamento API.
  2. Copie o Voice ID da sua voz clonada.
  3. Confirme se seu saldo de crédito API é suficiente.

Use esta voz do sistema para o primeiro teste:

00a1b221-6137-4b73-ad62-b0cbce134167

Configurar OpenTalking

Adicione ou atualize estes valores no arquivo backend .env do OpenTalking:

OPENTALKING_TTS_DEFAULT_PROVIDER=openai_compatible
OPENTALKING_TTS_OPENAI_BASE_URL=https://kittaai.com/v1
OPENTALKING_TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
OPENTALKING_TTS_OPENAI_MODEL=fishaudio-s21pro-flash
OPENTALKING_TTS_OPENAI_VOICE=00a1b221-6137-4b73-ad62-b0cbce134167
OPENTALKING_TTS_OPENAI_RESPONSE_FORMAT=wav
OPENTALKING_TTS_OPENAI_PROTOCOL=audio_speech

Se OPENTALKING_TTS_ENABLED_PROVIDERS já estiver definido, certifique-se de que sua lista separada por vírgulas inclua openai_compatible.

Use the Base URL ending at /v1

OpenTalking anexa /audio/speech a OPENTALKING_TTS_OPENAI_BASE_URL. Não coloque o completo Ponto de extremidade /v1/audio/speech nesta variável.

Reinicie o back-end do OpenTalking após alterar .env. Em Configurações, escolha OpenAI compatível com TTS, insira uma breve frase de visualização e reproduza a visualização de voz.

Limites do provedor

  • Essas configurações alteram apenas TTS. Configure os provedores LLM e ASR separadamente.
  • Mantenha audio_speech como protocolo. Kitta AI não é um provedor de áudio para conclusão de bate-papo.
  • Use wav para o primeiro teste porque o adaptador do OpenTalking decodifica WAV diretamente antes de transmitir o áudio para a conversa.
  • Substitua o ID de voz do sistema pela sua voz clonada somente após a visualização funcionar.

Solução de problemas

  • 404: use https://kittaai.com/v1 como URL base; OpenTalking adiciona /audio/speech.
  • 401: verifique OPENTALKING_TTS_OPENAI_API_KEY e reinicie o backend.
  • 402: adicione créditos API antes de tentar novamente.
  • 400 ou voz inválida: use fishaudio-s21pro-flash e um ID de voz Kitta AI válido.
  • TTS compatível com OpenAI não está disponível: adicione openai_compatible a OPENTALKING_TTS_ENABLED_PROVIDERS e reinicie.
  • Configurações alteradas, mas o áudio não: OpenTalking persiste a configuração de tempo de execução para o ambiente backend; confirme o modelo e a voz exibidos e reinicie o serviço afetado.

Documentação relacionada