Truman API ile Metinleri Sese Dönüştürme Hizmeti

Yazan Truman API editör ekibi · Güncellendi 2026-11-18

Truman API, freelancerlar ve WordPress geliştiricileri için tasarlanmış bir metin okuma API’sidir. Bu sayfada; seslerin lisans kökenini, veri gizliliği politikamızı ve teknik altyapımızı detaylıca inceliyoruz. Hedefimiz, yazılı içeriklerinizi programatik olarak sesli dosyalara dönüştürerek iş akışınızı otomatize etmenizi sağlamaktır.

Burada, kullandığımız seslerin LibriTTS-R verisetinden geldiğini ve CC BY 4.0 lisansı altında sunulduğunu bulacaksınız. Ayrıca, isteklerinizin nasıl işlendiğini, verilerinizin kullanımını ve WordPress entegrasyonu için gerekli teknik detayları bulabilirsiniz. Amacımız, şeffaf ve güvenilir bir altyapı sunmaktır.

Truman API ile Metinleri Sese Dönüştürme Hizmeti

Sıkça sorulan sorular

Yazı seslendirme nedir?

Yazı seslendirme, metinlerin API kullanılarak sesli dosyalara dönüştürülmesi işlemidir. Truman API, bu dönüşümü programatik olarak sağlar. Metin gönderilir, API işleme alır ve MP3, WAV, FLAC gibi formatlarda ses dosyası döndürür. Bu sayede içeriklerinizi otomatik olarak sesli hale getirebilirsiniz.

API nasıl çalışır?

POST isteği ile https://api.trumani.net/v1/audio/speech endpointine JSON gövde gönderirsiniz. Model, ses, format ve hız parametrelerini belirtirsiniz. API, metni işleyip ses dosyasını döndürür. OpenAI SDK yapısına benzer, bu nedenle mevcut entegrasyonlarınızı kolayca adapte edebilirsiniz. Sadece base_url ve API anahtarı değiştirilerek çalışır.

Hangi diller destekleniyor?

Arapça, Çince, Danca, Felemenkçe, İngilizce, Fince, Fransızca, Almanca, Yunanca, İbranice, Hintçe, İtalyanca, Japonca, Korece, Malayca, Norveççe, Lehçe, Portekizce, Rusça, İspanyolca, Svahili, İsveççe ve Türkçe desteklenir. Toplam 23 dildir. Sesler tüm dillerde kullanılabilir. Desteklenmeyen diller arasında Vietnamca, Endonezce, Tayca, Ukraynaca, Romence ve Çekçe bulunur.

Ses dosyası formatı nedir?

MP3, WAV, Opus, FLAC ve PCM formatları desteklenir. Format isteğe bağlıdır; belirtilmezse mp3 varsayılan olarak kullanılır. Her format farklı sıkıştırma ve kalite özellikleri sunar. FLAC ve PCM kayıpsız veya az sıkıştırılmış veri sağlar. MP3 ve Opus daha küçük dosya boyutu sunar. İsteğe bağlı olarak hız ve dil parametreleri ile format seçilebilir.

Hız ayarı nasıl yapılır?

Hız, 0.25 ile 4.0 arasında değişen bir parametre ile ayarlanır. Varsayılan hız 1.0'dır. Daha düşük değerler sesi yavaşlatır, daha yüksek değerler hızlandırır. Bu ayar, sesin doğal akışını bozmadan hızlanmasına veya yavaşlamasına olanak tanır. İsteğin JSON gövdesinde 'speed' alanı ile belirtilir.

Karakter sınırı var mıdır?

Evet, her istek için maksimum 4096 karakter sınırı vardır. Bu sınır, boşluklar ve noktalama işaretleri dahil toplam karakter sayısını kapsar. Daha uzun metinler için parçalara bölünerek gönderilmelidir. Her parça ayrı bir istek olarak işlenir ve sonuçlar birleştirilebilir. Bu, uzun içeriklerin de sorunsuz şekilde seslendirilmesini sağlar.

Rate limit nedir?

Her API anahtarı için dakikada 60 istek limiti vardır. İlk yükleme yapılmadan önce bu limit dakikada 10 istek olarak düşer. Bu limit, anahtar başına geçerlidir. Limit aşıldığında istekler reddedilir. Yüksek trafikli senaryolar için anahtar sayınızı artırabilir veya isteklerinizi zamanlayabilirsiniz. Limitler, API'nin stabil çalışmasını sağlar.

Hatalı istekler nasıl işlenir?

Sentez işlemi başarısız olursa, harcamanız tam olarak iade edilir. Hatalı istekler ücretsizdir. Bu, API'nin güvenilirliğini artırır. İstekleriniz sırasında oluşan teknik sorunlar maliyet yaratmaz. Yanıt kodlarına dikkat ederek hata ayıklaması yapabilirsiniz. Başarılı isteklerde ise karakter başına ücretlendirme yapılır. Bu, hata durumunda ekstra maliyet riskini ortadan kaldırır.

Uzun metinler nasıl işlenir?

Uzun metinler, 4096 karakterlik parçalara bölünerek gönderilmelidir. Her parça ayrı bir API isteği olarak işlenir. Oluşturulan ses dosyaları, istemci tarafında birleştirilerek uzun bir ses dosyası elde edilir. Bu yaklaşım, bellek sınırlarını aşmadan büyük metinlerin işlenmesini sağlar. Otomatik bölme ve birleştirme için kendi kodunuzu yazabilirsiniz.

Input formatı nedir?

Input, JSON gövdesinde 'input' alanı olarak gönderilen metindir. Maksimum 4096 karakter olabilir. Model, ses, format ve hız parametreleri de aynı gövdede belirtilir. Metin, UTF-8 kodlamasında olmalıdır. Boşluklar ve özel karakterler karakter sayısına dahil edilir. Gövde, OpenAI Speech endpoint formatına uygundur. Bu, standart entegrasyonları kolaylaştırır.

API anahtarı nasıl yenilenir?

Hesap panelinden yeni bir API anahtarı oluşturabilirsiniz. Eski anahtar anında geçersiz hale gelir. Bu, güvenlik açısından önemlidir. Anahtarlar tekil ve aktif olarak yönetilir. İhtiyaç duyduğunuzda yeni anahtar oluşturup eskiyi devre dışı bırakabilirsiniz. Bu işlem, mevcut istekleri etkilemez, ancak yeni isteklerde yeni anahtar kullanılmalıdır.

Karakter sınırı var mıdır?

Evet, her API isteği için maksimum 4096 karakter sınırı vardır. Bu sınır, metnin toplam uzunluğunu ifade eder. Boşluklar, sayılar ve noktalama işaretleri bu sınıra dahildir. 4096 karakteri aşan metinler, istemci tarafında bölünerek gönderilmelidir. Bu, API'nin verimli çalışmasını sağlar. Her parça ayrı bir ses dosyası olarak üretilir.

Hangi sesler kullanılabilir?

Aria, Nova, Luna, Sage, Felix, Milo, Atlas ve Orion sesleri mevcuttur. Aria (sıcak, net anlatıcı), Nova (parlak, enerjik), Luna (yumuşak, hikaye anlatıcısı), Sage (sakin, öğretici), Felix (enerjik, promosyon), Milo (samimi, sohbet), Atlas (nötr, haber) ve Orion (derin, belgesel) sesleri mevcuttur.

Dil otomatik algılanıyor mu?

Evet, dil otomatik olarak tahmin edilebilir. Latin alfabesi ile yazılmış metinler varsayılan olarak İngilizce olarak kabul edilir. Diğer diller için 'language' parametresi belirtilmelidir. Bu, yanlış dil algılamasını önler. Örneğin, Almanca metin için 'de' kodu kullanılmalıdır. Bu, sesin doğru telaffuzla üretilmesini sağlar. Dil kodu ISO standardına uygundur.

Ekip ve Misyon

İçin ses dalga görseli: Ekip ve Misyon

Truman API, WordPress geliştiricileri ve içerik üreticileri için metinleri yüksek kaliteli ses dosyalarına dönüştürmek üzere tasarlanmıştır. Hedefimiz, yazılı içeriğinizi programatik olarak sesli dosyalara dönüştürerek iş akışınızı otomatize etmektir.

Doğrudan entegre edebileceğiniz bir yapı sunarız.

Freelancer odaklı yaklaşım

Freelancer odaklı yaklaşım

Freelancerlar için zamanınızı değerli kılan bir API geliştiriyoruz. 60 istek/dakika limitleri ve basit fiyatlandırma ile ölçeklenebilir çözümler sunarız.

Teknik detaylara hakim, özeti seven geliştiriciler için hazırlanmış bu yapı, gereksiz katmanları ortadan kaldırır.

API odaklı hizmet

API odaklı hizmet

Arayüzler veya görsel düzenleyiciler yerine, doğrudan POST istekleri ve JSON verisi üzerinden çalışırız. Bu sayede her türlü senaryoya uyum sağlarsınız.

OpenAI SDK uyumlu yapımız, mevcut geliştirme ortamınızda entegrasyon imkanı sağlar.

WordPress entegrasyonu

WordPress entegrasyonu

Blog içeriklerinizi otomatik olarak sesli hale getirmek için API'nizi WordPress sitenize bağlayın. PHP istekleri ile otomasyonu kolayca yönetin.

İçeriklerinizi programatik olarak sesli dosyalara dönüştürerek kullanıcı deneyimini artırın ve iş akışınızı otomatize edin.

Ses Lisansları

İçin ses dalga görseli: Ses Lisansları

Truman API, ses kalitesini ve yasal güvenliği bir arada sunar. Sesler, telif hakları açısından net bir yapıda olup, lisanslama süreçlerindeki belirsizlikleri ortadan kaldırır.

Her ses dosyası, sentetik olduğunu belirten inaudible bir watermark taşır. Bu sayede, oluşturulan içeriğin yapay zeka tarafından üretildiği teknik olarak doğrulanabilir.

LibriTTS-R lisansı

LibriTTS-R lisansı

Kullanılan sesler, LibriTTS-R veri kümesinden elde edilmiştir. Bu veri kümesi, geniş kapsamlı ve yüksek kaliteli TTS eğitimi için özel olarak hazırlanmış açık kaynaklı bir kaynaktır.

LibriVox public domain

Ses kaynağı olan okumalar, LibriVox'un kamu malı (public domain) arşivinden alınmıştır. Bu, seslerin temel telif haklarının süresi dolmuş veya açık erişim kapsamında olduğunu gösterir.

CC BY 4.0 kullanım

LibriTTS-R, Creative Commons Attribution 4.0 (CC BY 4.0) lisansı altında yayımlanmıştır. Bu lisans, metinleri seslere dönüştürmek için sesleri özgürce kullanmanıza olanak tanır.

Veri Gizliliği

İçin ses dalga görseli: Veri Gizliliği

Girdi metinleriniz yalnızca ses dosyası üretimi amacıyla işlenir ve eğitim verisi olarak kullanılmaz. İşlem tamamlandığında oluşturulan ses dosyaları sunucularımızda saklanmaz; yalnızca faturalandırma kayıtları (zaman, karakter sayısı ve durum) tutulur.

Girdi metninin kullanımı

Metniniz API isteği ile birlikte işlenir ve ses dosyasına dönüştürülür. Bu süreçte kullanılan veriler, yalnızca o anki üretim için gereklidir ve kalıcı olarak depolanmaz.

Ses dosyalarının depolanmaması

Üretilen ses dosyaları yanıt üzerinden iletilir ve sunucularımızda arşivlenmez. Bu sayede verileriniz üzerinde uzun süreli bir iz bırakılmaz.

İsteğe bağlı dil kodu

Dil belirtilmezse sistem, metnin scriptine (Latin, Kiril vb.) göre varsayılan dili tahmin eder. Kesin bir sonuç için ISO dil kodunu kullanmanız önerilir.

Teknik Altyapı

İçin ses dalga görseli: Teknik Altyapı

Truman API, OpenAI Speech endpoint yapısına benzer bir yapıda çalışır. base_url parametresini https://api.trumani.net/v1 olarak ayarlayarak mevcut OpenAI SDK'larını doğrudan kullanabilirsiniz. Bu sayede mevcut kod yapınızı büyük ölçüde değiştirmeden entegrasyon sağlayabilirsiniz.

API anahtarlarınız dakikada 60 istekle sınırlıdır. İlk yükleme öncesi bu limit 10 istek/dakika seviyesindedir.

OpenAI SDK uyumluluğu

Teknik altyapımız, standart OpenAI Speech endpoint formatını takip eder. JSON body içinde model, input, voice ve response_format alanlarını belirterek ses dosyası üretimi gerçekleştirebilirsiniz. Bu standartlaşma, geliştiricilerin öğrenme süresini azaltır ve mevcut kütüphanelerle sorunsuz entegrasyon sağlar.

  • POST https://api.trumani.net/v1/audio/speech endpointi
  • OpenAI Python ve Node.js SDK'ları ile doğrudan uyumlu
  • JSON tabanlı istek yapısı

Rate limit yönetimi

Dakikada 60 istek limiti, API anahtarı başına geçerlidir. Limit aşıldığında HTTP 429 hatası döner; bekleyip yeniden deneme yaparak işlemlerinizi tamamlayabilirsiniz.

  • Standart limit: 60 istek/dakika
  • Başlangıç limiti: 10 istek/dakika
  • Yeni anahtar çıkarma ile limit sıfırlanır

Hata kodları

İstekler başarısız olduğunda, API standart HTTP hata kodlarını döner. Örneğin, geçersiz bir API anahtarı 401, limit aşımı 429, ve istek hatası 400 döner. Hata mesajları, sorunun kaynağını belirtir.

Başarısız isteklerde ücret alınmaz. Bu durum, hatalı yapılandırma sırasında bakiyenizin korunmasını sağlar ve geliştiriciler için güvenilir bir geri bildirim mekanizması sunar.

Teknik Altyapı

İletişim ve Destek

İçin ses dalga görseli: İletişim ve Destek

Truman API, karmaşık destek süreçleri yerine doğrudan ve teknik bir iletişim kanalı sunar. Freelancer ve WordPress geliştiricileri için destek, sorunun doğrudan ilgili e-posta adresine iletilmesiyle başlar. Telefon numarası veya canlı sohbet ekibi bulunmamaktadır; tüm iletişimler e-posta üzerinden yürütülür ve bu sayede teknik detaylar eksiksiz iletilir.

Destek sürecinde bekleme süresi, sunucu yüküne ve destek talebi yoğunluğuna göre değişebilir. Ancak, teknik dokümantasyon ve SSS sayfası, çoğu yaygın entegrasyon sorununu çözmenizi sağlar. Bu sayfa, API anahtarı yönetimi ve temel ayarlar hakkında hızlı referans için tasarlanmıştır.

E-posta desteği

Teknik destek ve genel sorularınız için destek e-posta adresimizi kullanın. Yanıt süresi, talep yoğunluğuna bağlı olarak değişebilir. Detaylı hata logları ve istek JSON'u paylaştığınızda çözüm süreci hızlanır.

  • Yalnızca e-posta iletişimi
  • Canlı sohbet ve telefon yok
  • Teknik detay odaklı yanıt

SSS erişimi

En sık sorulan teknik sorular ve WordPress entegrasyon ipuçları bu sitede yer alır. Entegrasyon sırasında karşılaşılan tipik hatalar ve çözüm yolları burada listelenmiştir.

  • WordPress uyumluluğu
  • Hata kodları
  • Karakter hesaplama

API anahtarı yönetimi

/get-api-key/ sayfasından mevcut anahtarınızı görüntüleyebilir ve yeni anahtar oluşturabilirsiniz. Yeni anahtar oluşturulduğunda eski anahtar anında geçersiz olur. Bu özellik, güvenlik açıkları durumunda veya farklı projeler için izole erişim sağlamak için kullanılır.

  • Tek aktif anahtar
  • Anında geçersiz kılma
  • Kullanım istatistikleri

Sıkça Sorulan Sorular

İçin ses dalga görseli: Sıkça Sorulan Sorular

Truman API, WordPress geliştiricileri için doğrudan HTTP istekleri veya mevcut OpenAI SDK'sı üzerinden entegrasyon sağlar. Bu sayede, blog yazılarınızı veya WooCommerce ürün açıklamalarınızı otomatik olarak sesli içeriğe dönüştürüp sitenize ekleyebilirsiniz. Özel bir WordPress eklentisi veya mobil uygulama gerekmez; standart REST API mimarisi kullanılır.

API'nin WordPress ile uyumluluğu

API, standart JSON formatında çalışır ve OpenAI SDK'sının base_url parametresi ile kolayca yapılandırılabilir. WordPress sitenizde bir PHP hook'u veya cron job ile istekleri gönderip, dönen WAV/MP3 dosyalarını medya kütüphanesine kaydedebilirsiniz. 4096 karakterlik sınır, uzun makaleleri parçalara bölerek çözülebilir.

Ses dosyalarının ticari kullanımı

Sesler, CC BY 4.0 lisanslı LibriTTS-R verisetinden ve Kamu Malı (Public Domain) LibriVox kayıtlarından türetilmiştir. Bu nedenle, oluşturulan ses dosyalarını ticari projelerde, videolarda veya web sitelerinde özgün içerik olarak kullanabilirsiniz. Girdi metniniz eğitim amaçlı kullanılmaz ve üretilen sesler kalıcı olarak saklanmaz.

Karakter sayısı nasıl hesaplanır?

Faturalandırma, karakter sayısına dayanır ve boşluklar ile noktalama işaretleri de dahil edilir. Örneğin, "Merhaba Dünya!" ifadesi 13 karakter olarak hesaplanır. Toplam maliyet, 1 milyon karakter başına 10 USD'dir; bu da 1.000 karakter için 0,01 USD anlamına gelir.

8 sesi dinleyin

Aşağıdaki her örnek, aynı cümle bu API tarafından üretilmiştir. Üretim maliyeti, işlenen metnin uzunluğuna doğrudan bağlıdır.

Sesin avatarı aria
ariakadın
Sesin avatarı nova
novakadın
Sesin avatarı luna
lunakadın
Sesin avatarı sage
sagekadın
Sesin avatarı felix
felixerkek
Sesin avatarı milo
miloerkek
Sesin avatarı atlas
atlaserkek
Sesin avatarı orion
orionerkek

23 dil

Her ses bu dillerden birini konuşabilir.

Kaynaklar ve ileri okuma

  1. Wikipedia
  2. Creative Commons Attribution 4.0
  3. openai-python on GitHub
  4. TRON developer hub: TRC-20
  5. ISO 639 language codes
  6. LibriTTS-R corpus (OpenSLR 141)
  7. IETF RFC 7845: Ogg Opus
  8. curl documentation
  9. LibriTTS-R paper (arXiv 2305.18802)
  10. Node.js documentation
  11. W3C WAI: making audio and video accessible
  12. LibriVox public-domain audiobooks

Sitede daha fazla