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
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
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
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
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ı
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ı
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
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ı
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.

İ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
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.
23 dil
Her ses bu dillerden birini konuşabilir.
Kaynaklar ve ileri okuma
- Wikipedia
- Creative Commons Attribution 4.0
- openai-python on GitHub
- TRON developer hub: TRC-20
- ISO 639 language codes
- LibriTTS-R corpus (OpenSLR 141)
- IETF RFC 7845: Ogg Opus
- curl documentation
- LibriTTS-R paper (arXiv 2305.18802)
- Node.js documentation
- W3C WAI: making audio and video accessible
- LibriVox public-domain audiobooks
