Guia de configuração Tavo
Configure Fish Audio como um provedor TTS personalizado compatível com OpenAI no Tavo e, em seguida, atribua vozes Fish Audio aos seus personagens.
#Conecte Fish Audio TTS ao Tavo
Este guia mostra como configurar Fish Audio como um provedor TTS personalizado compatível com OpenAI no Tavo e atribuir uma voz Fish Audio a um personagem. Após a configuração, Tavo pode ler mensagens de personagens com a voz selecionada.
O que você precisa
- Uma conta Fish Audio com créditos API;
- Uma chave Fish Audio API;
- O ID de voz Fish Audio que você deseja usar;
- Uma instalação funcional do Tavo.
Uma chave API é uma credencial confidencial. Não o envie para outras pessoas nem o inclua em mensagens de bate-papo, capturas de tela públicas ou sites não confiáveis. Crie uma chave dedicada para o Tavo para que você possa monitorá-la ou revogá-la separadamente.
Etapa 1: Crie uma chave Fish Audio API
Faça login em Fish Audio, abra o gerenciamento API e crie uma chave para Tavo. Copie e armazene-o imediatamente porque a chave completa só pode ser mostrada uma vez.
Etapa 2: Encontre um ID de voz
Tavo precisa de um Voice ID para sintetizar a fala com uma voz específica. Copie um da sua lista de vozes Fish Audio ou consulte o API:
Para testar a conexão imediatamente, comece com este ID de voz do sistema público:
00a1b221-6137-4b73-ad62-b0cbce134167Use-o para o teste de conexão inicial e, em seguida, substitua-o pelo seu ID de voz preferido depois que o Tavo puder gerar e reproduzir o áudio com sucesso.
GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEYNão confunda os campos modelo e voz: o modelo seleciona o mecanismo TTS, enquanto o Voice ID seleciona o som do alto-falante.
Etapa 3: Adicione uma voz API no Tavo
Em Tavo, abra:
More → Voice & Image Generation → Voice API → NewEscolha TTS Modelo de protocolo OpenAI personalizado e insira:
| Configuração Tavo | Valor |
|---|---|
| URL base API | https://fishaudio.org/v1 |
| Chave API | Sua chave Fish Audio API |
| ID do modelo | fishaudio-s21pro-flash |
| ID de voz | 00a1b221-6137-4b73-ad62-b0cbce134167 (substituir após teste) |
| Formato de áudio | mp3 |
O URL base deve terminar em /v1. Não anexe /audio/speech; Tavo adiciona o caminho /v1/audio/speech completo ao enviar uma solicitação.
Salve o provedor. Se o Tavo oferecer um teste de conexão, gere uma frase curta e confirme se o áudio é reproduzido.
Passo 4: Atribuir a voz a um personagem
Após criar a voz API, abra a tela de vinculação de voz do personagem Tavo:
Character Voice Binding → Select Character → Select Your Voice APISe Tavo solicitar um ID de voz, insira o mesmo ID de voz Fish Audio novamente. Salve a ligação, retorne ao bate-papo, envie uma mensagem curta e inicie a reprodução de voz.
Você pode atribuir uma voz Fish Audio diferente para cada personagem. Reutilize as configurações do provedor e altere apenas o Voice ID em cada ligação de caractere.
Uso de crédito API
Tavo gera fala por meio de Fish Audio /v1/audio/speech e consome o saldo de crédito API separado. A conversão de texto em fala começa com 1 crédito API por caractere efetivo e alguns modelos podem aplicar um multiplicador.
Compre créditos em preço API e visualize o saldo no gerenciamento API. O custo real da solicitação é retornado em X-OpenAPI-Credits-Used.
Solução de problemas e perguntas frequentes
Tavo relata falha de conexão
Confirme se o URL base é https://fishaudio.org/v1, remova os espaços em branco da chave API e verifique se a conta ainda possui créditos API. Não insira a senha da sua conta Fish Audio.
A solicitação retorna 401 ou diz que a chave API é inválida
Copie a chave Fish Audio API novamente. Caso tenha sido revogada, crie uma nova chave e substitua a antiga credencial armazenada no Tavo.
A solicitação retorna 402 ou diz que o saldo é insuficiente
Seu saldo de crédito API está muito baixo. Os créditos de associação e os créditos API são saldos separados, portanto, compre créditos API na página de preços API.
Tavo conecta mas não reproduz áudio
Verifique se o caractere está vinculado à voz API e se o ID da voz é válido. Teste primeiro uma frase curta com mp3 e, em seguida, verifique as configurações de reprodução automática, mudo e reprodução em segundo plano do Tavo.
Tavo diz que o modelo ou voz é inválido
Use fishaudio-s21pro-flash como ID do modelo e um ID de voz Fish Audio como voz. Nomes OpenAI como tts-1 e alloy não são mapeados automaticamente para modelos ou vozes Fish Audio.
Cada personagem pode usar uma voz diferente?
Sim. Insira o ID de voz Fish Audio correspondente para cada personagem para dar aos personagens vozes diferentes.