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

Guia de configuração TTS personalizado do Android

Conecte o serviço TTS personalizado para Android ao Kitta AI e use uma voz clonada em aplicativos que suportam o mecanismo TTS do sistema Android.

Use Kitta AI como mecanismo TTS do sistema Android

Serviço TTS personalizado para Android conecta um endpoint de fala compatível com OpenAI à interface de conversão de texto em fala do sistema Android. Os aplicativos que usam o mecanismo Android TTS selecionado podem ler texto com uma voz Kitta AI.

System TTS boundary

Isso funciona apenas em aplicativos Android que usam o mecanismo TTS do sistema operacional. Um aplicativo próprio o provedor de voz integrado pode ignorar a seleção do sistema Android.

Prepare a chave API e o ID de voz

  1. Crie uma chave dedicada em gerenciamento API.
  2. Copie o ID de voz 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

Instale e configure o mecanismo

Instale o APK da página de lançamento do projeto, abra o aplicativo e digite:

ConfiguraçãoValor
URL de back-endhttps://kittaai.com/v1/audio/speech
Chave APISua chave Kitta AI API
Modelo TTSfishaudio-s21pro-flash
Voz TTS00a1b221-6137-4b73-ad62-b0cbce134167
Formato de respostawav

Use the complete endpoint and WAV

O serviço Android posta diretamente no URL de back-end, portanto inclua /audio/speech. Sua versão atual suporta reprodução WAV e PCM, mas ainda não decodifica MP3 ou Opus; use wav para Kitta AI.

Toque em Salvar e em Abrir configurações do Android TTS e selecione TTS personalizado como o mecanismo preferido. Use a reprodução de amostra do Android ou o botão de leitura em voz alta de um aplicativo para testar uma frase curta.

Segurança e notas de voz

  • A chave API é armazenada no dispositivo Android. Use uma chave dedicada que possa ser revogada sem afetar outras integrações.
  • O campo Voz requer um ID de voz Kitta AI, não o nome de exibição da voz.
  • Substitua a voz de teste do sistema pela sua voz clonada somente após o primeiro teste ser bem-sucedido.
  • O acesso à rede é necessário sempre que o Android solicita ao mecanismo para sintetizar a fala.

Solução de problemas

  • Sem áudio: defina o formato de resposta como wav; MP3 e Opus estão listados, mas não são decodificados pelo aplicativo atual.
  • 404: O URL de back-end deve ser o endereço https://kittaai.com/v1/audio/speech completo.
  • 401: substitua a chave API salva por uma chave dedicada válida.
  • 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.
  • Outra voz é reproduzida: selecione TTS personalizado nas configurações do sistema TTS do Android e verifique se o aplicativo de destino usa o sistema TTS.

Documentação relacionada