tts joinery

TTS-Joinery

TTS-Joinery-это библиотека Python и инструмент CLI для оборудования ограничений длины в API-интерфейсах текста в речь.

Поскольку в настоящее время популярные API ограничены 4096 символами, эта библиотека будет:

• Создайте входной текст в предложения, используя модуль NLTK Punkt (для лучшего звука, избегая сегментов, разделенных в середине слова или предложения).
• Запустите каждый кусок через API TTS
• Включите полученный результат, чтобы создать один файл MP3

В настоящее время поддерживается только API OpenAI, с намерением добавить больше в будущем.

Установка

pip install tts-joinery

или используйте pipx для установки в качестве автономного инструмента.

Требуется FFMPEG для обработки аудиофайлов.

Установка может варьироваться в зависимости от вашей системы. На Linux вы можете использовать свой диспетчер пакетов системы. На Mac brew install ffmpeg должна работать.

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

Интерфейс командной строки (CLI)

CLI рассчитывает найти ключ API OpenAI в переменной среды OPENAI_API_KEY или в файле .ENV.

Синтаксис

 ttsjoin [OPTIONS] [COMMAND]

Параметры

 Options:
--input-file FILENAME   Plaintext file to process into speech, otherwise stdin
--output-file FILENAME  MP3 result, otherwise stdout
--model TEXT            Slug of the text-to-speech model to be used
--service TEXT          API service (currently only supports openai)
--voice TEXT            Slug of the voice to be used
--no-cache BOOLEAN      Disable caching
--help                  Show this message and exit.

Commands:
  cache [clear, show]

Примеры

1. Использование входного файла и указания выходного файла:

ttsjoin --input-file input.txt --output-file output.mp3 --model tts-1 --service openai --voice onyx

2. Использование stdin и stdout с параметрами по умолчанию:

 echo " Your text to be processed " | ttsjoin > output.mp3

3. Каждый кусок текста кэшируется для производительности при запуске одного и того же текста несколько раз, это может быть отключено:

ttsjoin --input-file input.txt --output-file output.mp3 --no-cache

5. Очистить каталог кэша

ttsjoin cache clear

Библиотека Python

Вы также можете использовать TTS-Joinery как часть вашего проекта Python:

 import nltk

from joinery . op import JoinOp
from joinery . api . openai import OpenAIApi

# Only need to download once, handled for you automatically in the CLI
nltk . download ( 'punkt_tab' , quiet = True )

tts = JoinOp (
    text = 'This is only a test!' ,
    api = OpenAIApi (
        model = 'tts-1-hd' ,
        voice = 'onyx' ,
        api_key = OPENAI_API_KEY ,
    ),
)

tts . process_to_file ( 'output.mp3' )

Изменение

v1.0.4 (2024-10-11)

• Исправлена ​​проблема с зависимостью № 4 NLTK #4
• Модели, голосовые и сервисные CLI Парамы теперь нечувствительны к случаям.

v1.0.3 (2024-10-05)

• Добавлены команды управления кэшем в CLI
• Исправлена ​​ошибка при запуске
• Добавлены сквозные тесты

v1.0.2 (2024-10-03)

• Фиксированный сбой при работе с отключенным кэшированием (#3)

Внося

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

Тест можно запускать вручную. Suite включает в себя сквозные тесты с живыми вызовами API, убедитесь, что у вас есть openai_api_key, установленная в .env.test и запустите pytest . Вы можете установить зависимости разработки с pip install -e .[test]

Участники

Особая благодарность:

• Mayank Vishwakarma (@mayankwebbing)

Лицензия

Этот проект лицензирован по лицензии MIT.

Copyright 2024, Эдриен Делиссерт