tts wrapper

Tts-wrapper

As contribuições são bem -vindas! Verifique nosso guia de contribuição.

O TTS-Wrapper facilita o uso de APIs de texto em fala, fornecendo uma interface unificada e fácil de usar.

Atualmente, os seguintes serviços são suportados:

• AWS Polly
• Google TTS
• Microsoft TTS
• IBM Watson
• Picotts
• SAPI (Microsoft Speech API)

Instalação

Instale usando PIP.

pip install TTS-Wrapper

Nota: Para cada serviço que você deseja usar, você deve instalar os pacotes necessários.

Exemplo: usar google e watson :

pip install TTS-Wrapper[google, watson]

Para picotts, você precisa instalar o pacote em sua máquina. Para o Debian (Ubuntu e outros), instale o pacote libttspico-utils e para Arch (Manjaro e outros), há um pacote chamado aur/pico-tts .

Uso

Simplesmente instancie um objeto do serviço desejado e ligue synth() .

 from tts_wrapper import PollyTTS , PollyClient

tts = PollyTTS ( client = PollyClient ())
tts . synth ( '<speak>Hello, world!</speak>' , 'hello.wav' )

Observe que você deve criar um objeto cliente para trabalhar com seu serviço. Cada serviço usa diferentes técnicas de autorização. Confira a documentação para saber mais.

Selecionando uma voz

Você pode alterar a voz padrão e Lang assim:

 PollyTTS ( voice = 'Camila' , lang = 'pt-BR' )

Confira a lista de vozes disponíveis para Polly, Google, Microsoft e Watson.

Ssml

Você também pode usar a marcação SSML para controlar a saída de motores compatíveis.

 tts . synth ( '<speak>Hello, <break time="3s"/> world!</speak>' , 'hello.wav' )

Recomenda -se usar o atributo ssml que criará as tags de caldeira corretas para cada mecanismo:

 tts . synth ( tts . ssml . add ( 'Hello, <break time="3s"/> world!' ), 'hello.wav' )

Saiba quais tags estão disponíveis para cada serviço: Polly, Google, Microsoft e Watson.

Autorização

Para configurar credenciais para acessar cada mecanismo, crie o respectivo cliente.

Polly

Se você não definir explicitamente credenciais, boto3 tentará encontrá -las no arquivo de credenciais do seu sistema ou em suas variáveis ​​de ambiente. No entanto, você pode especificá -los com uma tupla:

 from tts_wrapper import PollyClient
client = PollyClient ( credentials = ( region , aws_key_id , aws_access_key ))

Google

Aponte para o seu caminho de arquivo OAuth 2.0 Credenciais:

 from tts_wrapper import GoogleClient
client = GoogleClient ( credentials = 'path/to/creds.json' )

Microsoft

Basta fornecer sua chave de assinatura, assim:

 from tts_wrapper import MicrosoftClient
client = MicrosoftClient ( credentials = 'TOKEN' )

Se sua região não é o padrão "USEast", você pode mudar assim:

 client = MicrosoftClient ( credentials = 'TOKEN' , region = 'brazilsouth' )

Watson

Passe sua chave de API e URL para o inicializador:

 from tts_wrapper import WatsonClient
client = WatsonClient ( credentials = ( 'API_KEY' , 'API_URL' ))

Picotts & Sapi

Esses clientes não precisam de autorização, pois ficam offline.

 from tts_wrapper import PicoClient , SAPIClient
client = PicoClient ()
# or
client = SAPIClient ()

Formato de arquivo

Por padrão, todo o áudio será um arquivo de onda, mas você pode alterá -lo para um MP3 usando a opção format :

 tts . synth ( '<speak>Hello, world!</speak>' , 'hello.mp3' , format = ' mp3 )

Licença

Licenciado sob a licença do MIT.