Download tts joinery tts joinery

tts joinery

Código-Fonte de IA

v1.0.4

Baixar

TTS-Joinery

O TTS-Yoinery é uma biblioteca Python e uma ferramenta CLI para contornar as limitações de comprimento nas APIs de texto em fala.

Como as APIs atualmente populares são limitadas a 4096 caracteres, esta biblioteca será:

Coloque o texto de entrada em frases usando o módulo NLTK Punkt (para melhor áudio, evitando segmentos divididos no meio de uma palavra ou frase).
Execute cada pedaço pela API TTS
Junte -se a saída resultante para produzir um único arquivo MP3

Atualmente, apenas a API do OpenAI é suportada, com a intenção de adicionar mais no futuro.

Instalação

pip install tts-joinery

ou use pipx para instalar como uma ferramenta independente.

Requer FFMPEG para o processamento do arquivo de áudio.

A instalação pode variar dependendo do seu sistema. No Linux, você pode usar o gerenciador de pacotes do sistema. No Mac brew install ffmpeg deve funcionar.

Uso

Interface da linha de comando (CLI)

A CLI espera encontrar uma chave de API do OpenAI em uma variável de ambiente OPENAI_API_KEY , ou em um arquivo .env.

Sintaxe

 ttsjoin [OPTIONS] [COMMAND]

Opções

 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]

Exemplos

Usando um arquivo de entrada e especificando um arquivo de saída:

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

Usando stdin e stdout com opções padrão:

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

Cada pedaço de texto é armazenado em cache para desempenho ao executar o mesmo texto várias vezes, isso pode ser desativado:

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

Diretório de cache claro

ttsjoin cache clear

Biblioteca Python

Você também pode usar o TTS-Yoinery como parte do seu projeto 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' )

Changelog

v1.0.4 (2024-10-11)

Corrigido Problema com a dependência do NLTK #4
Os params de modelo, voz e serviço agora são insensíveis ao caso

v1.0.3 (2024-10-05)

Adicionados comandos de gerenciamento de cache à CLI
Corrigido um bug ao executar
Testes de ponta a ponta adicionados

v1.0.2 (2024-10-03)

Falha corrigida ao executar com cache desativado (#3)

Contribuindo

As contribuições são bem -vindas, particularmente outras APIs do TTS, verifiquem os problemas de antemão e sinta -se à vontade para abrir um PR. O código é formatado com preto.

O teste pode ser executado manualmente. A suíte inclui testes de ponta a ponta com chamadas de API ao vivo, verifique se você tem um OpenAI_API_KEY definido no .env.test e execute pytest . Você pode instalar dependências de desenvolvimento com pip install -e .[test]