Configuração do OpenCrabs

#Conecte Fish Audio TTS ao OpenCrabs

OpenCrabs suporta qualquer endpoint compatível com /v1/audio/speech e pode transformar respostas de agentes em mensagens de voz para Telegram, WhatsApp, Discord ou Slack.

Configurar TTS

Editar config.toml:

[voice]
tts_enabled = true
tts_mode = "openai_compatible"
tts_base_url = "https://fishaudio.org/v1"
tts_model = "fishaudio-s21pro-flash"
tts_voice = "00a1b221-6137-4b73-ad62-b0cbce134167"

Armazene a chave API em keys.toml:

[providers.tts.openai_compatible]
api_key = "YOUR_API_KEY"

Não envie keys.toml para um repositório público. Você também pode executar /onboard:voice, selecionar Compatível com OpenAI e inserir o mesmo URL, modelo e voz de forma interativa.

Teste a conexão

Reinicie o OpenCrabs e acione uma resposta curta através de um canal conectado. Após a reprodução do áudio, substitua a voz de teste pelo seu [ID de voz] preferido (/pt/docs/api-reference/voices/list).

OpenCrabs lida com codificação de áudio para cada canal de mensagens. Primeiro verifique se o arquivo de áudio é reproduzido e, em seguida, verifique se o canal o exibe como um balão de voz nativo.

Solução de problemas

• Extremidade 404: o URL base é https://fishaudio.org/v1, não um URL de página de documentação.
• Local Piper ainda é usado: defina tts_mode como openai_compatible.
• Nenhuma fala é gerada: confirme tts_enabled = true e se o canal permite anexos de áudio.
• 401/402: verifique a chave em keys.toml e o saldo credor API.

Documentação relacionada

• OpenAI compatível com TTS
• Erros API
• Guia de voz oficial do OpenCrabs