tts wrapper

Tts-wrapper

¡Las contribuciones son bienvenidas! Verifique nuestra guía de contribución.

TTS-Wrapper hace que sea más fácil usar API de texto a voz al proporcionar una interfaz unificada y fácil de usar.

Actualmente se admiten los siguientes servicios:

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

Instalación

Instale con PIP.

pip install TTS-Wrapper

Nota: Para cada servicio que desea utilizar, debe instalar los paquetes requeridos.

Ejemplo: para usar google y watson :

pip install TTS-Wrapper[google, watson]

Para Picotts debe instalar el paquete en su máquina. Para Debian (Ubuntu y otros) instale el paquete libttspico-utils y para Arch (Manjaro y otros) hay un paquete llamado aur/pico-tts .

Uso

Simplemente instanciar un objeto del servicio deseado y llamar synth() .

 from tts_wrapper import PollyTTS , PollyClient

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

Observe que debe crear un objeto cliente para trabajar con su servicio. Cada servicio utiliza diferentes técnicas de autorización. Consulte la documentación para obtener más información.

Seleccionando una voz

Puede cambiar la voz predeterminada y el lang así:

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

Consulte la lista de voces disponibles para Polly, Google, Microsoft y Watson.

Ssml

También puede usar el marcado SSML para controlar la salida de motores compatibles.

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

Se recomienda usar el atributo ssml que creará las etiquetas correctas de Boilerplate para cada motor:

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

Aprenda qué etiquetas están disponibles para cada servicio: Polly, Google, Microsoft y Watson.

Autorización

Para configurar las credenciales para acceder a cada motor, cree el cliente respectivo.

Polly

Si no define explícitamente las credenciales, boto3 intentará encontrarlas en el archivo de credenciales de su sistema o en sus variables de entorno. Sin embargo, puede especificarlos con una tupla:

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

Google

Señale la ruta de archivo de credenciales OAuth 2.0:

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

Microsoft

Simplemente proporcione su clave de suscripción, así:

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

Si su región no es el "USEAST" predeterminado, puede cambiarlo así:

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

Watson

Pase su clave API y URL al inicializador:

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

Picotts y Sapi

Estos clientes no requieren autorización ya que se quedan sin conexión.

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

Formato de archivo

De forma predeterminada, todo el audio será un archivo de onda, pero puede cambiarlo a un mp3 usando la opción format :

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

Licencia

Licenciado bajo la licencia del MIT.