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

Guia de configuração do AstrBot

Conecte o AstrBot ao Kitta Audio pelo OpenAI TTS Provider e use sua voz clonada nas respostas do agente.

Conectar o Kitta Audio TTS ao AstrBot

O AstrBot pode chamar o Kitta Audio por um endpoint de voz compatível com OpenAI. Personas e provedores TTS são gerenciados separadamente: crie primeiro o provedor e atribua-o pela configuração padrão ou por uma regra personalizada.

Preparar API Key e Voice ID

Crie uma chave na página de API, copie o Voice ID da sua voz clonada e confira os créditos de API. Para o primeiro teste, use esta voz pública:

00a1b221-6137-4b73-ad62-b0cbce134167

Adicionar o provedor TTS

No painel do AstrBot, adicione um provedor de texto para fala e escolha OpenAI TTS (API).

ConfiguraçãoValor
API KeySua API Key do Kitta Audio
API Base URLhttps://fishaudio.org/v1
Modelfishaudio-s21pro-flash
VoiceVoice ID da voz clonada
Timeout60 segundos recomendado

A Base URL deve terminar em /v1; o AstrBot chama /v1/audio/speech automaticamente.

Não selecione FishAudio TTS (API)

Esse provedor usa outra API nativa e exige um reference ID hexadecimal de 32 caracteres. Para vozes do fishaudio.org, use OpenAI TTS Provider e o Voice ID da plataforma.

Ativar respostas de voz

Ative TTS no AstrBot e selecione o provedor criado. Para vários agentes, crie um provedor por Voice ID e associe persona e provedor TTS com regras personalizadas.

Solução de problemas

  • Voice inválida: informe o Voice ID, não o nome exibido.
  • 404: use https://fishaudio.org/v1 sem duplicar /audio/speech.
  • 401/402: confira a chave e o saldo separado de créditos de API.
  • API incorreta: escolha OpenAI TTS (API), não FishAudio TTS (API).
  • Timeout: defina 60 segundos e teste primeiro um texto curto.

Documentação relacionada