gTTS nedir?
gTTS, Google Translate’in metinden sese (TTS) hizmetine istek göndererek yazıyı konuşulan MP3 sesine çeviren açık kaynaklı bir Python kütüphanesi ve komut satırı aracıdır. Çıktıyı bir dosyaya, ses işlemeye uygun dosya benzeri bir nesneye ya da doğrudan stdout’a yazabilirsiniz. Pierre Nicolas Durette tarafından geliştirilmiş ve MIT lisansıyla dağıtılır. PyPI’de haftada yaklaşık 175.000 indirme ile en çok indirilen TTS paketlerinden biridir. Python'da 3 satırda metni MP3’e çevirmeniz gerektiğinde genelde ilk karşınıza çıkan araç gTTS’dir.
Ancak, gTTS’nin Google Cloud Text-to-Speech olmadığını aklınızda tutmak çok önemli. Google Translate’deki “Dinle” butonunu çalıştıran, belgelenmemiş aynı arka uca bağlanır. Bu fark, gTTS'nin nerelerde parladığını, nerelerde sınırlı kaldığını ve hangi durumlarda başka çözümlere yönelmeniz gerektiğini belirler.
gTTS Ne Zaman Kullanılır?
gTTS’yi ücretsiz, hızlı prototipleme, metinden MP3 üretmek için tek satırlık komutlar, çok dilli demolar, hobi projeleri, sınıf içi örnekler veya erişilebilirlik skriptleri (ör. bir Google Dokümanları çıktısını sesli okuma) için kullanın. Prodüksiyon düzeyinde güvenilirlik, dokümantasyonlu SLA, ses klonlama, SSML, neural/ifade edici sesler, anlık ses akışı veya açık ticari lisans gerekliyse gTTS uygun değildir.
gTTS Nasıl Çalışır?
gTTS yerelde konuşma üretmez. Google Translate’in “Dinle” özelliğinin arka ucuna istek gönderir, oluşan MP3 dosyasını indirir ve size baytlar olarak döndürür. Yani çevrimdışı kullanım yoktur; internet bağlantısı gerekir ve ses Google’ın sunucularında üretilir. Kullanılan uç nokta da resmî değildir. Proje Google ile resmî olarak bağlantılı değildir ve Google tarafından yapılan değişiklikler habersiz kırılmalara yol açabilir.
Kurulum
bash
pip install gTTS
gTTS, Python 3.7+ gerektirir ve macOS, Windows, Linux’ta çalışır. Güncel PyPI sürümü 2.5.4 (Kasım 2024). Debian tabanlı sistemlerde — Raspberry Pi OS dâhil — pip paketi gTTS, apt paketi python3-gtts’dır. pip install, yeni işletim sisteminde externally-managed-environment hatası verirse sanal ortama kurun.
Temel Kullanım
En basit örnek:
python
from gtts import gTTS
tts = gTTS("Hello, world.")tts.save("hello.mp3")
Komut Satırından:
bash
gtts-cli "hello" --output hello.mp3
Dil ve Aksan Seçimi
python
tts = gTTS("Bonjour le monde", lang="fr")tts.save("bonjour.mp3")
gTTS ayrıca tld parametresiyle bölgesel alt etiketler sunar — örn.
tld="co.uk" İngiliz aksanı için, tld="ca" Kanada Fransızcası için; isteği farklı Google Translate alan adlarından geçirir.
Yavaş Mod
python
tts = gTTS("Read this slowly.", lang="en", slow=True)tts.save("slow.mp3")
Tüm konuşma kontrol seçenekleri aslında bu kadar. Pitch parametresi yok, yavaş mod dışında hız ayarı yok, ses seçimi hiç yok, SSML desteği yok.
Diske Değil, Belleğe Akış (Buffer)
python
from io import BytesIOfrom gtts import gTTS
buf = BytesIO()gTTS("Stream me").write_to_fp(buf)buf.seek(0)# şimdi buf’u pydub, ffmpeg, web yanıtına aktarabilirsiniz
Ön İşleme & Uzun Metin
gTTS’nin öne çıkan özelliklerinden biri de tokenizer’ı. Çok uzun metni, arka ucun kabul ettiği parçalara böler (her istekte yaklaşık 100 karakter), birleşimlerde tonlamayı korur, kısaltma, nokta ve diğer işaretleme hatalarını doğru yönetir. Ayrıca, sık telaffuz sorunu yaşanan kelimeler için kendi ön işlemcilerinizi ekleyebilirsiniz — örneğin marka adlarını ya da kısaltmaları harf harf okunacak şekilde dönüştürebilirsiniz.
gTTS’in Avantajları Nelerdir?
gTTS (Google Text-to-Speech), hafif, kullanımı kolay ve Python iş akışlarına rahatça entegre edilebildiği için geliştiriciler arasında popülerdir. MP3 ses dosyaları üretebilir, çıktıyı dosyaya, dosya benzeri nesneye ya da doğrudan stdout’a kaydedebilir; bu da onu otomasyon ve script projelerinde esnek kılar. 60 civarı dili ve tld ayarlarıyla birden fazla lehçe desteğiyle basit uygulamalar için çok dilli çözüm sunar. Komut satırı (gtts-cli), shell scriptlerine kolayca eklenebilir ve kısaltma, sayı, metin dönüşümü için özelleştirilebilir tokenizer ve ön işlemciler sağlar. Minimal Python API sayesinde Jupyter Notebook, Flask uygulamaları, Discord botları gibi hafif projelere konuşma özelliği kazandırmak çok rahattır.
gTTS’in Dezavantajları Nelerdir?
Basitliğine rağmen gTTS, modern AI ses platformlarına göre çeşitli kısıtlar barındırır. Sesler standart Google Translate tabanlı olup iş görür; ancak yeni nesil neural metinden sese sistemler kadar doğal tonlama, duygu ve gerçeklik sunmaz. Tek dilde birden fazla ses seçilemez; SSML desteği, pitch ayarı, ince ayarlı konuşma hızı yoktur. gTTS, gerçek zamanlı akış yerine MP3’ü indirip oynatır; bu da etkileşimli uygulamalarda gecikmeyi artırır. Tüm istekler internet bağlantısı gerektirir; ağ çağrısı olmadan çalışmaz, çevrimdışı uygun değildir. Güvenilirlik veya düşük gecikme gerektiren ortamlar için pek elverişli değildir.
Geliştiriciler için gTTS’nin Sınırlamaları Nelerdir?
1. Belgelenmemiş uç noktada hız limiti
“Hello world” ötesine geçen herkes için asıl kritik konu budur. gTTS bir kota yayınlamaz çünkü kullandığı servisin de yayınlanan bir kotası yoktur. Pratikte tek bir IP, çoğu zaman saatte on binlerce karakter gönderebilir, ardından Google HTTP 429 döndürmeye başlar; tam sınır, trafiğe göre değişir. Uygulamanız tek bir sunucudan çok kullanıcıya ses üretiyorsa bu limitlere mutlaka takılırsınız ve SLA yoktur.
2. Uç nokta habersiz değişebilir
gTTS, kamuya açık sürümlenmiş bir API yerine iç Google Translate yolunu kullandığı için, Google istek imzası veya yanıtlarını değiştirerek bir gecede gTTS’yi bozabilir. Geliştirici bir yama yayınlar, siz
pip install -U gTTS ve devam. Hobi scripti için sorun değil. Üretimde, gece 2’de can sıkıcı olabilir.
3. Bakım sıklığı
Projede hâlâ yeni sürüm çıkıyor; son 12 ayda en az bir kez güncellendi, ama issue yanıtları yavaş ve esasen tek kişilik bir ekip var. Bazı paket sağlık takipçileri depoyu "aktif değil" olarak işaretliyor. MIT lisanslı, ücretsiz bir kütüphane için olağan; ancak ücretli ürününüz için temelde kritikse iyi düşünün.
4. Ticari ve kullanım şartlarının belirsizliği
gTTS, Google Cloud TTS yerine Google Translate’in ön yüzünü kullandığı için, ticari seslerin lisanslanmasının nasıl yapılacağı açıkça belirtilmemiştir. Kütüphanenin kendisi MIT lisanslıdır; aldığınız ses dosyaları, Google’ın TTS API’si olarak sunulmayan bir hizmetinin şartlarına tabidir. Hukuk ekibinizden net yanıt gerekiyorsa, gTTS bunu veremez.
5. Hassas veriler bilgisayarınızı terk eder
Oluşturduğunuz her metin Google’ın sunucularına gönderilir. İç belgeler, müşteri bilgileri veya Google Dokümanları ve benzeri kaynaklardan alınan içerikleri seslendiriyorsanız, göndermeden önce veri güvenliği açısından bunu tartmanız gerekir.
gTTS ile Google Cloud Text-to-Speech Arasındaki Farklar Nelerdir?
gTTS ile Google Cloud Text-to-Speech genellikle karıştırılsa da aynı ürünler değiller. Başlıca farklar:
Üretimde Google sesi gerekiyorsa gTTS yerine Google Cloud TTS’yi seçmeniz tavsiye edilir.
Ne Zaman Profesyonel TTS API’sine Geçilmeli?
gTTS’den profesyonel metinden sese API’sine geçiş zamanı; ses kalitesi, güvenilirlik ve özelleştirme ihtiyaçlarının projeniz için önemine bağlıdır. gTTS basitliği ve ücretsiz olmasıyla prototip, portfolyo projeleri, kişisel erişilebilirlik araçları, eğitim demoları ve hafif denemeler için idealdir. Ancak, ücretli kullanıcılara sunulan bir ürün geliştirdiğinizde, kullanıcı deneyiminde konuşma kalitesi kritik hâle geldiğinde ya da düşük gecikmeli, SLA’lı güvenilirlik gerekiyorsa profesyonel API şart olur. Gelişmiş ses seçenekleri, ses klonlama, SSML, ses akışı, doğrusal okuma ve telaffuz ayarı veya açık ticari lisans isteniyorsa da profesyonel çözüme geçiş mantıklıdır. Projeler olgunlaşıp üretime çıktıkça bu özellikler vazgeçilmez hâle gelir.
gTTS mi, Speechify API mi Seçilmeli?
Speechify metinden sese API resmî destekli, ücretli bir servis olup neural sesler, dil başına birden fazla ses seçeneği, SSML desteği ve sözleşmede açıkça tanımlı ticari lisansa sahiptir; belgelenmemiş uç nokta kullanmaz. gTTS’de hız limiti, ses kalitesi veya kullanım şartları sizi zorlamaya başladıysa, geçiş için güçlü adaylardan biridir.
SSS
gTTS ücretsiz mi?
Evet, gTTS ücretsiz ve MIT lisanslı bir Python kütüphanesidir; ancak ticari seviyede lisanslı ses için Speechify API gibi ücretli bir servis gerekir.
gTTS çevrimdışı çalışır mı?
Hayır, gTTS internet bağlantısına ihtiyaç duyar çünkü Google sunucularıyla iletişim kurar; Speechify API de bulut tabanlıdır.
gTTS’i ticari projede kullanabilir miyim?
gTTS’nin ticari kullanım için ürettiği seslerin lisanslaması, belgelenmemiş Google uç noktasına dayandığı için belirsizdir; Speechify API ise açıkça ticari lisans sağlar.
gTTS’de sesi nasıl değiştiririm?
Değiştiremezsiniz. gTTS dil başı tek ses sunar; Speechify API ise seçebileceğiniz neural ses kataloğu sunar.
gTTS SSML destekliyor mu?
Hayır, gTTS’nin SSML desteği, pitch veya hassas hız kontrolü yoktur; Speechify API ise tam prozodi kontrolü için SSML destekler.
gTTS neden HTTP 429 hatası döndürüyor?
Google Translate’in gizli hız sınırına takıldınız; çoğu geliştirici böyle durumlarda SLA sunan servislere — örn. Speechify API — geçiş yapar.
gTTS ile Google Cloud Text-to-Speech aynı mı?
Hayır, gTTS resmî olmayan Translate uç noktasını kullanır; Google Cloud TTS ise ücretli, ayrı bir üründür. Speechify API ise başka bir ücretli neural ses alternatifi sunar.
Üretime uygun en iyi Python TTS kütüphanesi hangisi?
gTTS prototip için yeterli ama üretim için uygun değildir; üretim yüklerinde çoğu geliştirici Speechify API gibi ücretli API’lere geçer.
gTTS ses klonlayabilir mi?
Hayır, ses klonlama gTTS’de yoktur ama Speechify API ile mümkündür.
gTTS’de ses nasıl akış olarak oynatılır?
gTTS gerçek zamanlı akış desteklemez; tamamlanmış MP3 döndürür. Düşük gecikmeli akış için Speechify API kullanılabilir.
