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-b0cbce134167Adicionar o provedor TTS
No painel do AstrBot, adicione um provedor de texto para fala e escolha OpenAI TTS (API).
| Configuração | Valor |
|---|---|
| API Key | Sua API Key do Kitta Audio |
| API Base URL | https://fishaudio.org/v1 |
| Model | fishaudio-s21pro-flash |
| Voice | Voice ID da voz clonada |
| Timeout | 60 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/v1sem 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
60segundos e teste primeiro um texto curto.
Documentação relacionada
Configuração do OpenClaw
Use o provedor OpenClaw OpenAI TTS com Kitta Audio para respostas de voz no Telegram, WhatsApp e outros canais.
Configuração do assistente doméstico
Use um endpoint personalizado HACS OpenAI TTS para criar anúncios Kitta Audio e respostas do assistente de voz no Home Assistant.