tts joinery

TTS-JOINERY

TTS-JOINERY adalah pustaka Python dan alat CLI untuk mengatasi batasan panjang di API teks-ke-pidato.

Karena API yang saat ini populer dibatasi hingga 4096 karakter, perpustakaan ini akan:

• Potong teks input ke dalam kalimat menggunakan modul NLTK Punkt (untuk audio yang lebih baik dengan menghindari segmen yang terpecah di tengah kata atau kalimat).
• Jalankan setiap potongan melalui API TTS
• Bergabunglah bersama output yang dihasilkan untuk menghasilkan satu file MP3

Saat ini hanya API Openai yang didukung, dengan niat untuk menambahkan lebih banyak di masa depan.

Instalasi

pip install tts-joinery

Atau gunakan pipx untuk menginstal sebagai alat mandiri.

Membutuhkan FFMPEG untuk pemrosesan file audio.

Instalasi dapat bervariasi tergantung pada sistem Anda. Di Linux Anda dapat menggunakan Manajer Paket Sistem Anda. Di Mac brew install ffmpeg harus berfungsi.

Penggunaan

Antarmuka baris perintah (CLI)

CLI mengharapkan untuk menemukan kunci API openai dalam variabel lingkungan OPENAI_API_KEY , atau dalam file .env.

Sintaksis

 ttsjoin [OPTIONS] [COMMAND]

Opsi

 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]

Contoh

1. Menggunakan file input dan menentukan file output:

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

2. Menggunakan stdin dan stdout dengan opsi default:

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

3. Setiap bagian teks di -cache untuk kinerja saat menjalankan teks yang sama beberapa kali, ini dapat dinonaktifkan:

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

5. Direktori Clear Cache

ttsjoin cache clear

Perpustakaan Python

Anda juga dapat menggunakan TTS-joinery sebagai bagian dari proyek Python Anda:

 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)

• Memperbaiki masalah dengan ketergantungan NLTK #4
• Model, Suara, dan Layanan Params CLI sekarang tidak peka

v1.0.3 (2024-10-05)

• Menambahkan perintah manajemen cache ke CLI
• Memperbaiki bug saat berjalan
• Menambahkan tes ujung ke ujung

v1.0.2 (2024-10-03)

• Memperbaiki crash saat berjalan dengan caching dinonaktifkan (#3)

Berkontribusi

Kontribusi selamat datang, terutama API TTS lainnya, periksa masalah sebelumnya dan jangan ragu untuk membuka PR. Kode diformat dengan hitam.

Tes dapat dijalankan secara manual. SUITE termasuk tes ujung ke ujung dengan panggilan API langsung, memastikan Anda memiliki OpenAI_API_Key di .env.test , dan jalankan pytest . Anda dapat menginstal dependensi pengembangan dengan pip install -e .[test]

Kontributor

Terima kasih khusus kepada:

• Mayank Vishwakarma (@mayankwebbing)

Lisensi

Proyek ini dilisensikan di bawah lisensi MIT.

Hak Cipta 2024, Adrien Delessert