Sıkça sorulan sorular
Metin seslendirme API'si nedir?
SesArayüzü, metinleri sesli dosyalara dönüştüren bulut tabanlı bir TTS API'sidir. POST isteği ile JSON formatında veri gönderir, karşılığında ses dosyası alırsınız. İstekler, OpenAI Speech endpoint yapısına benzer; bu nedenle OpenAI SDK'larını base_url değiştirerek kullanabilirsiniz. Endpoint: https://api.rip3.info/v1/audio/speech.
Sesli asistanlar için TTS neden önemlidir?
Sesli asistanlar ve sohbet botları için metin seslendirme, kullanıcı deneyimini zenginleştirir. API, 23 dilde doğal sesler sunar. Sesler, lisanslı kayıtlara dayandığı için tutarlı bir kalite sağlar. Bu sayede botlarınız daha profesyonel ve anlaşılır hale gelir; kullanıcılar metin okumak yerine dinlemeyi tercih eder.
Hangi dil desteklendi?
API, 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 dillerini destekler. Toplam 23 dildir. Desteklenmeyen diller arasında Vietnamca, Endonezce, Tayca ve Ukraynaca yer alır.
Sesler doğal mı?
Sesler, LibriTTS-R veri setinden (CC BY 4.0) ve LibriVox kamu malı ses kayıtlarından türetilmiştir. Her ses dosyası, sentetik olduğunu belirten görünmez bir su işareti içerir. Sesler gerçek insan seslerinin kopyası değildir; özel bir ses klonlama özelliği sunulmaz. Kalite, lisanslı kayıtların standartlarına uygundur.
Kaç karakter gönderilebilir?
Her bir API isteğinde maksimum 4096 karakter gönderilebilir. Daha uzun metinler için karakterleri bu sınırı aşmayacak şekilde parçalara bölüp ayrı istekler göndermeniz gerekir. Gelen ses dosyalarını birleştirerek uzun metinleri de seslendirebilirsiniz. Boşluklar ve noktalama işaretleri de karakter sayısına dahildir.
Ses hızı ayarlanabilir mi?
Evet, ses hızı 0.25 ile 4.0 arasında ayarlanabilir. Bu, sesli asistanlarınızın konuşma temposunu ihtiyaçlarınıza göre hızlandırmanıza veya yavaşlatmanıza olanak tanır. Hız parametresi, API isteğindeki 'speed' alanı aracılığıyla kontrol edilir.
Hangi ses formatları mevcut?
API, MP3, WAV, Opus, FLAC ve PCM ses formatlarını destekler. İsteğinizde 'response_format' alanını belirterek istediğiniz formatı seçebilirsiniz. Bu esneklik, farklı platformlar ve oynatıcılar ile uyumlu çalışmanızı sağlar. Ses dosyaları, seçilen formatta doğrudan yanıt olarak döndürülür.
Başarısız istekler ücretli mi?
Hayır, sentezleme işlemi başarısız olursa ücret alınmaz. Başarısız istekler için kredi tam olarak iade edilir. Sadece başarılı ve tamamlanan sentezleme işlemlerinden karakter başına ücretlendirme yapılır. Bu politika, hata durumlarında kullanıcıları korur.
Kaç istek yapabiliriz?
Anahtar başına dakikada 60 istek ile sınırlısınız. İlk yükleme yapılmadan önce bu limit dakikada 10 istek olarak düşer. Bu kısıtlama, sunucu yükünü yönetmek içindir. Uzun metinler için parçalı istekler gönderirken bu limiti göz önünde bulundurun. Limitler, API anahtarınızın durumuyla ilgilidir.
Hangi sesler kadın sesi?
Kadın sesleri şunlardır: Aria (sıcak, net anlatıcı), Nova (parlak, enerjik), Luna (yumuşak, hikaye anlatıcı) ve Sage (sakin, öğretici). Bu sesler, özellikle sohbet botları ve asistanlar için uygun tonlar sunar. İsteğinizde 'voice' alanına bu isimleri belirterek seçim yapabilirsiniz.
Hangi sesler erkek sesi?
Erkek sesleri şunlardır: Felix (enerjik, promosyon), Milo (samimi, konuşma), Atlas (nötr, haber) ve Orion (derin, belgesel). Bu sesler, farklı içerik türleri için uygundur. API isteğinde 'voice' parametresi ile bu seslerden birini seçerek metninizi seslendirebilirsiniz.
Dil otomatik algılanır mı?
Evet, 'language' parametresi belirtilmezse dil otomatik tahmin edilir. Latin alfabesiyle yazılmış metinler varsayılan olarak İngilizce olarak kabul edilir. Latin olmayan metinler için script'e göre tahmin yapılır. Ancak, Latin alfabesiyle yazılmış İngilizce dışındaki diller için 'language' parametresini açıkça belirtmeniz önerilir.
Karakterler sayılır mı?
Evet, tüm karakterler sayılır. Boşluklar, noktalama işaretleri ve harfler dahil olmak üzere metnin tamamı karakter sayısına dahildir. Fiyatlandırma, 1 milyon karakter başına 10 ABD Dolarıdır. Bu, 1.000 karakter başına 0,01 ABD Doları anlamına gelir. Hesaplamalar bu şekilde yapılır.
Hız sınırı var mı?
Ses hızı 0.25 ile 4.0 arasında sınırlıdır. Bu aralık dışında değerler gönderilemez. Bu sınırlar, doğal bir konuşma akışı sağlamak için belirlenmiştir. Hız parametresi, API isteğinde 'speed' olarak belirtilir. Belirtilen aralıkta değerler, ses dosyasının üretim süresini etkiler ancak fiyatlandırmayı değiştirmez.
İlk istek
curl
curl https://api.rip3.info/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3API Temel Özellikleri
Sesli asistanlar ve sohbet botları için tasarlanan API, POST https://api.rip3.info/v1/audio/speech endpointi üzerinden çalışır. Metin gönderirsiniz, ses dosyası alırsınız.
POST endpoint yapısı
İstekler, sunucuya HTTPS üzerinden JSON formatında iletilir. Bu yapı, API'nin temel veri alışveriş mekanizmasını oluşturur ve istemci tarafında herhangi özel bir kütüphane gerektirmez.
JSON tabanlı istekler
İstek gövdesi, model adı, ses türü, hız ve dil gibi parametreleri barındırır. input alanı, seslendirilecek metni içerir ve maksimum 4096 karakter sınırına sahiptir.
OpenSDK uyumluluğu
Endpoint yapısı, OpenAI Speech endpointiyle aynı şekildedir. Bu uyumluluk sayesinde, resmi OpenAI SDK'larını base_url parametresini https://api.rip3.info/v1 olarak değiştirerek doğrudan kullanabilirsiniz.
Desteklenen Sesler
Sistemimiz, metinleri doğal ve anlaşılır bir tona dönüştürmek için dört temel ses profili sunar. Kadın sesleri genellikle anlatıcı ve samimi bir yapıya sahipken, erkek sesleri daha çok haber, belgesal veya canlı tanıtım içerikleri için optimize edilmiştir.
Her ses, telif hakkı açısından lisanslı kaynaklardan beslenir. Üretilen her ses dosyasında, sentetik olduğunu belirleyen görünmez bir su işareti bulunur.
Kadın sesler (Aria, Nova)
Aria, sıcak ve net bir anlatıcı tonuyla uzun metinler ve kitap okumaları için uygundur. Nova ise parlak ve enerjik bir yapı sunar; özellikle kısa tanıtımlar veya sosyal medya içerikleri için dikkat çekicidir.
Luna ve Sage gibi diğer kadın sesleri de hikaye anlatımı ve eğitici içerikler için alternatifler sağlar.
- Aria: Sıcak, net anlatıcı
- Nova: Parlak, enerjik
- Luna: Yumuşak, hikaye anlatıcı
- Sage: Sakin, eğitici
Erkek sesler (Felix, Milo)
Felix, yüksek enerjili ve canlı bir yapıya sahiptir; promosyon içerikleri için idealdir. Milo ise daha samimi ve günlük konuşma diline yakın bir tonla sohbet botlarında doğal bir etkileşim sağlar.
Atlas ve Orion gibi erkek sesleri, nötr haber okumaları ve derinlikli belgesel anlatıları için tasarlanmıştır.
- Felix: Canlı, promosyon
- Milo: Samimi, konuşma
- Atlas: Nötr, haber
- Orion: Derin, belgesel
Doğal tonlama
Sesler, LibriTTS-R veri setinden alınan CC BY 4.0 lisanslı kayıtlardan ve LibriVox kamu malı ses kayıtlarından beslenir. Bu sayede robotik tınılar azaltılmış, insan sesine yakın bir üretim hedeflenmiştir.
Dil Desteği
API, Türkçe dahil olmak üzere 23 farklı dili destekler. Arapçadan İngilizceye, Rusçadan Japoncaya kadar geniş bir dil yelpazesiyle çok dilli projeleriniz için tek bir endpoint üzerinden ses üretimi yapabilirsiniz.
Sistem, metnin scriptine dayanarak dili otomatik tahmin eder. Ancak Latin alfabesi kullanan İngilizce dışındaki metinlerde dilin yanlış algılanmasını önlemek için ISO dil kodunu açıkça belirtmeniz önerilir.
Türkçe dahil 23 dil
Seslendirme motoru, Türkçe'nin yanı sıra Almanca, İspanyolca, Fransızca, İtalyanca, Korece ve Çince gibi 23 dili destekler.
- Türkçe, İngilizce, Almanca, İspanyolca, Fransızca, İtalyanca
- Arapça, Çince (Basitleştirilmiş), Japonca, Korece, Hintçe
- Svahili, Malay, Felemenkçe, Yunanca, İbranice
- Lehçe, Portekizce, Rusça, İsveççe, Norveççe
- Fince, Danca, Türkçe
Otomatik dil algılama
API, gönderilen metnin karakter yapısını analiz ederek dili otomatik olarak algılar. Örneğin, Latin alfabesi kullanan metinler varsayılan olarak İngilizce olarak işlenir.
ISO kodu ile dil seçimi
Doğru telaffuz için language parametresini kullanın. Örneğin, Almanca metin gönderirken language: 'de' değeri ile dil kodunu açıkça belirtmeniz, sesin doğal çıkmasını sağlar.
Ses Çıktı Formatları
API, farklı kullanım senaryolarına uyum sağlayacak şekilde beş farklı ses formatı sunar. İhtiyacınıza göre MP3, WAV, OPUS, FLAC veya PCM formatlarından birini seçerek ses dosyalarını elde edebilirsiniz.
Bu esneklik, hem web uygulamalarında hem de mobil ortamlarda sorunsuz çalışmanızı sağlar. Her format, üretim sürecindeki ihtiyaçlarınıza göre optimize edilmiştir.
MP3 ve WAV desteği
MP3, geniş uyumluluğu ve küçük dosya boyutuyla web ve mobil uygulamalar için idealdir. WAV formatı ise kayıpsız kalite sunar ve doğrudan düzenleme araçlarında çalışmak için uygundur.
- Geniş platform desteği
- Düşük dosya boyutu
- Kayıpsız ses kalitesi
- Doğrudan editör uyumu
OPUS ve FLAC seçenekleri
OPUS, yüksek sıkıştırma oranıyla düşük bant genişliğinde bile net ses kalitesi sağlar. FLAC, veri kaybı olmadan ses dosyasını küçülterek arşivleme ve yüksek kaliteli depolama için mükemmeldir.
- Yüksek sıkıştırma
- Net kalite
- Veri kaybı yok
- Verimli depolama
PCM ham ses verisi
PCM, kodlanmış olmayan ham dijital ses verisi sağlar. Bu format, ses verisi üzerinde ek işlemler yapmak veya özel kodlama çözümleri uygulamak isteyen geliştiriciler için temel bir seçenek sunar.
- Ham veri akışı
- Ek işlemler için uygun
- Özel kodlama desteği
- Temel ses formatı
Hız ve Performans
Ses üretimi genellikle uzun metinlerde gerçek zamanlı hızda ilerler; saniyede yaklaşık 25 karakterlik metin işlenir. Kısa cümleler birkaç saniye sürebilir ve yoğunluk altında istekler sıraya girebilir.
Gerçek zamanlı üretim
Sistem, uzun metinlerde yaklaşık gerçek zamanlı hızda çalışır. Kısa ifadeler için üretim birkaç saniye sürebilir ve bu süre, sunucu yüküne bağlı olarak değişebilir.
Uzun metinler için bölme
Her istek maksimum 4096 karakteri kapsar. Daha uzun metinler, client tarafında veya API kullanıcısı tarafından parçalara bölünmeli ve resulting audio dosyaları birleştirilmelidir.
Kuyruk yönetimi
İstekler sırayla işlenir. Yüksek trafik anlarında, gelen istekler işlenebilir kapasiteye göre bekleyebilir.

Hız Ayarı
Ses dosyasının oynatma hızını ayarlayarak metnin sunum şeklini özelleştirebilirsiniz. Hız parametresi, üretilen audio akışının ne kadar hızlı veya yavaş işleneceğini belirler.
0.25x hız
Daha yavaş, daha belirgin bir anlatım için minimum 0.25x hız ayarını kullanın. Bu ayar, özellikle karmaşık terimlerin veya teknik verilerin net duyulması gereken senaryolarda işe yarar.
4.0x hız
İçeriği hızlandırmak için maksimum 4.0x hız değerini seçin. Bu ayar, kısa uyarılar veya hızlı bilgi akışı gerektiren durumlarda zaman tasarrufu sağlar.
Esnek hız kontrolü
0.25 ile 4.0 arasında isteğinize bağlı herhangi bir hız değeri girebilirsiniz.
Hız ayarı, sesin tonunu veya dilini değiştirmez; yalnızca karakterlerin okunma ritmini etkiler. Her bir istek için ayrı hız belirleyerek farklı içerik türlerini tek bir API çağrısı içinde yönetebilirsiniz.
Ücretsiz Deneme
Bağımsız yazılımcılar için API entegrasyonunu test etmenin en hızlı yolu, Google kimliğinizle tek tıkla giriş yapmaktır. Hesap oluştururken ek bilgi isteği yoktur; bu sayede ses kalitesi ve dil desteği hakkında fikir sahibi olabilirsiniz.
Google ile giriş
Hesap açılışı sırasında ekstra onay gerektirmez. Doğrudan API anahtarınızı alarak hemen kullanmaya başlayabilirsiniz.
0.50$ başlangıç kredisi
Kayıt olduğunuz anda hesabınıza 0,50 dolar değerinde kredi yüklenir. Bu bakiye, yaklaşık 50.000 karakterlik metnin seslendirilmesine yetecek kadar kaynağa sahiptir ve harcamalarınızın gerçekçi bir ön izlemesini sunar.
7 gün geçerlilik
Başlangıç kredisi, kayıt tarihinden itibaren 7 gün boyunca geçerlidir. Bu süre içinde kullanılmayan bakiye düşmez, ancak deneme hakkı süresi dolduğunda sona erer.
Kullanım Limitleri
API'niz her dakika en fazla 60 istek gönderebilir. Bu limit, hesap oluşturulduktan sonra ilk yüklemeniz yapılana kadar dakikada 10 istek ile sınırlıdır. İlk yükleme yapıldığında limit 60'a yükselir.
Bu kısıtlama, sunucuların kalitesini korumas ve uzun metinlerin bile zamanında işlenmesi için tasarlanmıştır.
Dakikada 60 istek
Her API anahtarı için dakikada 60 istek limitiniz vardır. Hesabınız yeni oluşturulduğunda ve henüz para yatırmadığınız sürece bu limit dakikada 10 isteğe düşer. İlk yükleme işlemi onaylandığında limit hemen artar.
Bu yapı, ani trafik artışlarında bile servisin stabil kalmasını sağlar.
- İlk yükleme öncesinde: Dakikada 10 istek
- Yükleme sonrası: Dakikada 60 istek
4096 karakter sınırı
Her bir API çağrısı en fazla 4096 karakter içerebilir. Bu sınır, metnin parçalara bölünmesi gerektiğinde mantık geliştirmenizi gerektirir. Boşluklar ve noktalama işaretleri de karakter sayısına dahil edilir.
Uzun metinleri seslendirmek için metni bu sınırı aşmayacak şekilde bölüp, sonuçları ardışık olarak birleştirebilirsiniz.
Başarısız istekler ücretsiz
Sentez işlemi sırasında bir hata oluşursa, o istek için yapılan ücret tam olarak iade edilir. Bu, geçici sunucu yoğunluklarında veya geçici ağ sorunlarında riskinizi azaltır.
Sadece başarıyla üretilen ses dosyaları için ücretlendirme yapılır.
Entegrasyon Kolaylığı
Sistem, OpenAI Speech endpoint yapısıyla uyumlu olduğundan geliştiriciler için öğrenme süreci minimum düzeydedir. JSON tabanlı istekler ve standart HTTP metodları sayesinde herhangi bir özel SDK yüklemesi gerekmez; doğrudan cURL veya popüler HTTP kütüphaneleri ile entegrasyon sağlanır.
API, platformdan bağımsızdır. İster Node.js, ister Python veya Go ile çalışın, temel veri alışverişi aynı kalır. Bu durum, mevcut projelerinize sesli asistan özelliklerini hızlıca eklemenizi sağlar.
Teknoloji bağımsızlık
Kullandığınız programlama dili veya framework önemli değildir. API, standart HTTP protokolü üzerinden çalıştığı için her türlü modern yazılım dili ile sorunsuz entegre edilebilir. Bu, mevcut mimarinizi bozmadan yeni özellikler eklemenizi sağlar.
HTTP istekleri
İstekler, JSON formatında POST metodu ile gönderilir. Yanıt olarak doğrudan ses dosyası alınır. Başlık kısmında Bearer token kimlik doğrulaması yeterlidir. Karmaşık protokol gereksinimleri yoktur.
Kolay kurulum
API key'i aldıktan sonra tek bir istek ile çalışmaya başlayabilirsiniz. Gerekli kütüphaneler zaten mevcut geliştirici ortamlarında standarttır. Ekstra yapılandırma dosyası veya özel ayarlar gerektirmez.
8 sesi dinleyin
Aşağıdaki her örnek, aynı cümle bu API tarafından üretilmiştir. Doğru dil algılaması, özellikle çok dilli sohbet botları için kritik öneme sahiptir.
23 dil
Her ses bu dillerden birini konuşabilir.
