tts wrapper

TTS-WRAPPER

Взносы приветствуются! Проверьте наше руководство по взносу.

TTS-WRAPPER облегчает использование API-интерфейсов текста в речь, предоставляя унифицированный и простой в использовании интерфейс.

В настоящее время поддерживаются следующие услуги:

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

Установка

Установите с помощью PIP.

pip install TTS-Wrapper

Примечание. Для каждой службы, которую вы хотите использовать, вы должны установить необходимые пакеты.

Пример: использовать google и watson :

pip install TTS-Wrapper[google, watson]

Для Picotts вам нужно установить пакет на машине. Для Debian (Ubuntu и других) установить пакет libttspico-utils , а для Arch (Manjaro и других) есть пакет под названием aur/pico-tts .

Использование

Просто создайте экземпляр объекта из желаемой службы и Call synth() .

 from tts_wrapper import PollyTTS , PollyClient

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

Обратите внимание, что вы должны создать клиент -объект для работы с вашей службой. Каждая служба использует различные методы авторизации. Проверьте документацию, чтобы узнать больше.

Выбор голоса

Вы можете изменить голос по умолчанию и как это так:

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

Проверьте список доступных голосов для Полли, Google, Microsoft и Watson.

SSML

Вы также можете использовать разметку SSML для управления выводом совместимых двигателей.

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

Рекомендуется использовать атрибут ssml , который создаст правильные теги шаблонов для каждого двигателя:

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

Узнайте, какие теги доступны для каждой службы: Polly, Google, Microsoft и Watson.

Авторизация

Чтобы настроить учетные данные для доступа к каждому двигателю, создайте соответствующий клиент.

Полли

Если вы не определяете учетные данные, boto3 попытается найти их в файле учетных данных вашей системы или переменных вашей среды. Тем не менее, вы можете указать их с помощью кортежа:

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

Google

Укажите свой путь файла учетных данных OAuth 2.0:

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

Microsoft

Просто предоставьте свой ключ подписки, например:

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

Если ваш регион не по умолчанию «Useast», вы можете изменить его так:

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

Уотсон

Передайте свой ключ API и URL в инициализатор:

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

Picotts & Sapi

Эти клиенты не требуют авторизации, так как они работают в автономном режиме.

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

Формат файла

По умолчанию все аудио будет волновым файлом, но вы можете изменить его на MP3, используя параметр format :

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

Лицензия

Лицензирован по лицензии MIT.