TTS API Nedir ve Sesli Asistanlarda Nasıl Kullanılır?

Yazan SesArayüzü editör ekibi · Güncellendi 2026-11-19

Sesli asistanlar ve sohbet botları geliştiren bağımsız yazılımcılar için hazırlanan bu rehber, bulut tabanlı metin okuma API’sinin teknik yapısını ve entegrasyon süreçlerini adım adım açıklar. Metinleri yüksek kaliteli ses dosyalarına dönüştürmek için kullanılan HTTP isteklerini, JSON veri yapısını ve endpoint kullanımlarını detaylandırarak, geliştiricilerin API’yi kendi projelerine hızlıca dahil etmesini sağlar.

Türkçe dahil 23 dil desteği, hız ayarı ve farklı ses formatları gibi özellikler sayesinde esnek bir ses motoru elde edersiniz. Karakter başı şeffaf fiyatlandırma ve ücretsiz deneme kredisi ile risk almadan başlayabilirsiniz. Bu sayfa, API anahtarınızı almadan önce teknik gereksinimleri ve veri gizliliği ilkelerini netleştirmeniz için hazırlanmıştır.

TTS API Nedir ve Sesli Asistanlarda Nasıl Kullanılır?

Sıkça sorulan sorular

TTS API ne anlama gelir?

TTS API, metin seslendirme (Text-to-Speech) uygulaması geliştiricileri için tasarlanmış bir bulut hizmetidir. Metin gönderdiğinizde, sunucularınızda işlenen bu metni ses dosyasına dönüştürür. Bu sayede uygulamalarınıza veya sohbet botlarınıza doğal sesli geri bildirim özellikleri ekleyebilirsiniz.

Sesli asistanlar neden API kullanır?

API kullanımı, ses motorunu bağımsız olarak yönetmenizi sağlar. Bu mimari, sesli asistanlarınızın farklı platformlara ve dillere kolayca entegre edilmesini sağlar. Ayrıca, ses kalitesini ve dil desteğini merkezi olarak güncelleyerek geliştirme süreçlerinizi hızlandırır ve esneklik kazandırır.

API nasıl çalışır?

POST isteği ile JSON formatında metni gönderirsiniz. Sunucu metni ses dosyasına dönüştürür ve yanıt olarak döndürür. İstekler sırayla işlenir; 4096 karakteri aşan uzun metinler için bölme ve dosya birleştirme işlemi istemci tarafında yapılmalıdır. Bu süreç standart HTTP istekleri üzerinden gerçekleşir ve OpenAI SDK uyumluluğu sunar.

Hangi diller desteklenir?

Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish dilleri desteklenir. Toplam 23 dil mevcuttur. Belirtilmezse metnin script'ine göre dil tahmini yapılır.

Sesler doğal mi?

Sesler, lisanslı kayıtlar (LibriTTS-R, LibriVox) üzerine temellendirilmiştir. Her ses dosyası, yapay zeka tarafından üretildiğini gösteren görünmez bir su işareti taşır. Sesler gerçek insan seslerinin klonu değildir; ancak doğal ve anlaşılır bir konuşma deneyimi sunarlar.

Hız limiti nedir?

Her API anahtarı için dakika başına 60 istek limiti uygulanır. İlk yükleme yapılmadan önce bu oran dakikada 10 istek olarak sınırlıdır. Uzun metinler için ses dosyaları birleştirilir. Yoğunluk altında istekler sıraya alınabilir ve işlenme süresi değişebilir.

Kaç karakter gönderilebilir?

Her bir API isteğinde maksimum 4096 karakter gönderilebilir. Bu karakterler boşlukları ve noktalama işaretlerini de içerir. Daha uzun metinler için, metni bu sınırı aşmayacak şekilde parçalara bölmek ve sonuçları birleştirmek gerekir. Bu, verimli veri işleme sağlar.

Hangi formatlar mevcut?

Ses dosyaları MP3, WAV, OPUS, FLAC ve PCM formatlarında üretilebilir. Bu formatlar, farklı kullanım senaryolarına ve platform gereksinimlerine uygun olarak seçilebilir. İsteğinizdeki response_format alanı ile istediğiniz formatı belirtebilirsiniz. Bu seçenekler esnek kullanım sağlar.

Fiyatlandırma nasıl?

Fiyatlandırma, her 1 milyon karakter başına 10 ABD Doları olarak belirlenmiştir. Başarısız istekler ücretsizdir ve ücret iade edilir. Aylık planlar veya minimum harcama yoktur. Bakiye süresizdir ve TRON ağı üzerinden USDT ile yüklemeler yapılır.

Ücretsiz deneme var mı?

Google ile giriş yapan hesaplar, 7 gün geçerli 0,50 ABD Doları (yaklaşık 50.000 karakter) ücretsiz deneme kredisi alır. E-posta ve şifre ile kayıtlı hesaplar bu krediyi almaz. Bu kredi, API'yi test etmek için ideal bir başlangıç noktasıdır.

Verilerim güvende mi?

Girdi metniniz sadece ses üretimi için kullanılır ve eğitim amaçlı kaydedilmez. Üretilen ses dosyaları yanıt olarak döndürülür ve saklanmaz. Sadece faturalandırma için istek meta verileri (zaman, karakter sayısı, durum) saklanır. Bu, verilerinizin gizliliğini korur.

Sesler kaydedilir mi?

Üretilen ses dosyaları yanıt olarak size iletilir ve sunucularımızda kalıcı olarak kaydedilmez. Girdi metniniz de eğitim için kullanılmaz. Ancak, faturalandırma için istek meta verileri (zaman damgası, karakter sayısı) saklanır.

Meta veri ne saklanır?

İstek meta verileri arasında istek zamanı, işlenen karakter sayısı ve istek durumu (başarılı/başarısız) yer alır. Bu bilgiler, faturalandırma ve kullanım analizi için tutulur. Girdi metni veya üretilen ses dosyası bu meta veriler arasında yer almaz.

Nasıl başlarım?

/get-api-key/ sayfasından Google veya e-posta ile hesap oluşturun. API anahtarınızı alın ve /docs/ sayfasındaki örnekleri takip edin. Kodunuzu yapılandırın ve ses dosyası üretmeye başlayın. Destek e-posta ile sağlanır. Hızlı entegrasyon için hazır örnekler mevcuttur.

API Tanımı

İçin ses dalga görseli: API Tanımı

Sesli asistanlar ve sohbet botları için kullanılan bulut tabanlı bir metin okuma hizmetidir. Sistem, gönderilen metni yüksek kaliteli ses dosyasına dönüştürerek uygulamanıza iletilir.

OpenAI speech endpoint yapısına uygun çalışan bu API, mevcut SDK'ların base_url değişikliğiyle doğrudan kullanılmasını sağlar. Bu sayede geliştiriciler ekstra kütüphane yükü olmadan entegrasyon yapabilir.

Bulut hizmet

Sunucu tarafında yürütülen bu hizmet, istemci cihazların işlem gücünden bağımsız olarak metinleri ses dosyasına çevirir. Her istek, API sunucularında işlenir ve sonuç döndürülür.

  • Bağımsız bir altyapı
  • Ölçeklenebilir yapı

Metin ses dönüşümü

Gönderilen her metin, seçilen modele göre sentezlenir. TTS-1 veya TTS-1-HD modelleri, karakter sınırları (4096 karakter) içinde kalan metinleri ses dosyasına dönüştürür.

API yapısı

POST isteği ile https://api.rip3.info/v1/audio/speech endpoint'ine veri gönderilir. JSON formatında model, input, voice ve response_format alanları belirtilir. Auth başlığı Bearer token ile doğrulanır.

  • JSON tabanlı istekler
  • Standard HTTP metodları

Sesli Asistan Entegrasyonu

İçin ses dalga görseli: Sesli Asistan Entegrasyonu

Sesli asistanlarda metin girişi, kullanıcının konuşma veya yazdığı verinin doğrudan API'ye iletilmesiyle başlar. Girdi, karakter sınırı (4096 karakter) içinde kalacak şekilde hazırlanır.

Sistem, bu metni sesli bir çıktıya dönüştürür. Bu süreç, asistanın kullanıcıyla kuracağı diyalogun temelini oluşturur ve doğal bir deneyim sağlar.

Metin girişi

Kullanıcının girdisi, sistem tarafından doğrudan API endpoint'ine gönderilir. Metin, maksimum 4096 karakteri aşmamalıdır. Uzun metinler, parçalara bölünerek işlenebilir.

  • Doğrudan metin iletimi
  • Karakter sınırı kontrolü
  • Otomatik parçalama desteği

Ses çıktısı

API, işlenen metni sesli dosya olarak döndürür. Bu dosya, MP3, WAV veya FLAC gibi formatlarda olabilir. Ses, asistanın sesli yanıtı olarak kullanılır.

  • Çeşitli ses formatları
  • Hızlı ses üretimi

Gerçek zamanlı kullanım

Sesli asistanlar, metni sese dönüştürür; uzun metinlerde üretim hızı gerçek zamanlıya yakındır, ancak kısa cümleler için birkaç saniye harcanabilir ve istekler sırayla işlendiğinden kuyrukta bekleme süresi oluşabilir. Bu, kullanıcıyla etkileşimin akıcı olmasını sağlar. Gecikme süresi, sistem yüküne göre değişebilir.

  • Anlık ses üretimi
  • Kullanıcı etkileşimi
  • Düşük gecikme süresi

Teknik Gereksinimler

İçin ses dalga görseli: Teknik Gereksinimler

Sesli asistan geliştirme sürecinde, metnin ses dosyasına dönüşmesi için basit bir HTTP POST isteği yeterlidir. İstemci tarafında özel bir kütüphane yüklemeye gerek yoktur; standart HTTP kütüphaneleri veya OpenAI SDK’sı (base_url değiştirilerek) doğrudan kullanılabilir.

HTTP istekleri

API, POST https://api.rip3.info/v1/audio/speech endpoint’ine JSON formatında veri gönderilmesini bekler. Her istek, doğrulanmış bir API anahtarı ile Authorization: Bearer tts-... başlığı altında kimlik doğrulaması yapar. İstekler sırayla işlenir; yüksek trafikte kuyrukta bekleme süresi oluşabilir.

  • Kimlik doğrulama: Bearer token
  • Yöntem: POST
  • Kapasite: Dakikada 60 istek

JSON verisi

İstek gövdesi, model (tts-1 veya tts-1-hd), input (metin), voice (ses seçeneği) ve isteğe bağlı speed (0.25–4.0) alanlarını içerir. Metin 4096 karakteri geçmemelidir. Dil belirtilmezse script’e göre tahmin edilir; Türkçe için language: tr ayarı önerilir.

Endpoint kullanımı

Sunucu, başarı durumunda ses dosyasını döndürür. Desteklenen formatlar mp3, wav, opus, flac ve pcm’dir. Sentez işlemi başarısız olursa, harcanan karakter kredisi tamamen iade edilir. Ses dosyaları yanıt üzerinden alınır ve sunucuda saklanmaz; yalnızca faturalandırma için metadata kaydedilir.

Dil Desteği

İçin ses dalga görseli: Dil Desteği

Sesli asistanların en kritik bileşeni dilsel doğruluktur. API, 23 farklı dili destekleyerek geniş bir coğrafi yelpazede hizmet verebilme esnekliği sunar. Bu sayede geliştiriciler, tek bir API anahtarı ile global projelerini kolayca yönetebilirler.

Türkçe destek

API, Türkçe metinleri yüksek doğrulukla işler. Sesli asistanlarınızda doğal bir iletişim kurmak için Türkçe karakterler ve cümle yapıları sorunsuz şekilde ses dosyasına dönüştürülür.

23 dil

Arabis, Çince, Almanca, İspanyolca, İngilizce ve diğerleri dahil toplam 23 dil mevcuttur. Her ses, her dili destekler; yani Aria sesiyle Türkçe veya Felix sesiyle İngilizce konuşabilirsiniz. Vietnamca, Endonezca, Tayca, Ukraynaca, Romence, Çekçe, Bengalce ve listede yer almayan diğer diller desteklenmemektedir.

  • Arabis, Ç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, Türkçe.

Otomatik algılama

language parametresi belirtilmezse API, metnin scriptine (Latin, Kiril vb.) bakarak dili tahmin eder. Latin alfabesiyle yazılmış metinler varsayılan olarak İngilizce olarak kabul edilir. Türkçe veya diğer Latin tabanlı diller için language alanını açıkça belirtmeniz önerilir.

Ses Kalitesi

İçin ses dalga görseli: Ses Kalitesi

Sesli asistanların kullanıcı deneyimini belirleyen en kritik unsur, üretilen sesin doğal ve anlaşılır olmasıdır. SesArayüzü, 8 farklı preset ses seçeneği sunarak metinlerin doğru vurgu ve tonlama ile okunmasını sağlar. Her ses, belirli bir tona sahiptir: 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).

Doğal sesler

Seçilebilir 8 preset ses arasından, asistanınızın tonuna en uygun olanı belirleyebilirsiniz. ARIA, NOVA, LUNA, SAGE, FELIX, MILO, ATLAS ve ORION; her biri farklı bir iletişim stiline odaklanarak metnin akıcılığını artırır.

Lisanslı kayıtlar

Sesler, CC BY 4.0 lisansı altında kullanılan LibriTTS-R veri setinden ve Kamu Malı (public domain) LibriVox ses kayıtlarından türetilmiştir. Bu sayede ticari kullanım için lisans belirsizliği yaşanmaz ve yüksek kaliteli referans verilerle çalışılır.

Su işareti

Oluşturulan her ses dosyasının içinde, sesin yapay zeka tarafından üretildiğini belirten duyulmaz bir su işareti (watermark) bulunur. Bu özellik, içeriklerin kaynağını doğrulamak ve otomatik tespit mekanizmalarına uyum sağlamak için tasarlanmıştır.

Performans

İçin ses dalga görseli: Performans

Metin ses dönüşümü bulut tabanlıdır ve istekler sırayla işlenir. Uzun metinlerde gerçek zamanlı hıza yakın bir üretim gerçekleşir; ancak kısa cümleler için birkaç saniye harcanabilir.

Yüksek trafikte istekler kuyruğa alınabilir. Bu, istemcinin beklemesi gerektiği anlamına gelir. Performans, sunucu yüküne ve kuyruk durumuna göre değişir; istekler sırayla işlenir.

Hız limiti

Her API anahtarı dakikada 60 isteğe izin verir. İlk yükleme yapılmadan önce bu limit dakikada 10'a düşer. Bu sınır, aşırı yüklenmeyi önler.

Kuyruk sistemi

İstekler sırayla işlenir. Sunucu yoğun olduğunda yeni istekler kuyruğa eklenir. Bu durum, aynı anda çok sayıda istek gönderildiğinde görülür.

  • Tek bir anahtar için geçerlidir
  • Sıralı işleme ensures order
  • Kuyruk dinamik olarak genişler

Bekleme süresi

Kısa metinler için bile birkaç saniye harcanabilir. Uzun metinlerde üretim süresi, metnin uzunluğuyla orantılıdır. Kuyruk bekleme süresi eklenir.

Fiyatlandırma

İçin ses dalga görseli: Fiyatlandırma

API hizmetimiz karakter bazlı şeffaf bir fiyatlandırma modeli sunar. Her 1.000 karakter için 0,01$ (1 milyon karakter başına 10$) ücret alınır. Boşluklar ve noktalama işaretleri de karakter sayısına dahildir. Sentez işlemi başarısız olursa, harcanan karakter kredisi tamamen iade edilir.

Karakter başı fiyat

Kullanım, gönderilen metnin uzunluğuna göre hesaplanır. Belirli bir sabit aylık ücret veya paket yoktur. İsteğiniz işlenemezse veya hata verirse, o isteğe ait karakter kredisi hesabınıza geri yüklenir.

  • Fiyat: 10$ / 1 milyon karakter ($0,01 / 1.000 karakter)
  • Hatalı istekler ücretsizdir
  • Boşluklar ve noktalama dahil

Ücretsiz deneme

Google ile giriş yaparak hesabınıza 0,50$ deneme kredisi yüklenir. Bu bakiye yaklaşık 50.000 karakterlik metin sentezi yapmanıza olanak tanır. Deneme kredisi 7 gün içinde geçerliliğini yitirir. E-posta ve şifre ile kurulan hesaplar bu başlangıç kredisine sahip olmaz.

Şeffaf faturalandırma

Ödemeler USDT (TRC-20) üzerinden yapılır. Minimum yükleme tutarı 5$'dır. Transferler genellikle birkaç dakika içinde otomatik olarak işleme alınır. Fatura kesilmez, KDV eklenmez. Bakiye süresiz olarak saklanır ve herhangi bir son kullanma tarihi yoktur.

Fiyatlandırma

Entegrasyon Adımları

İçin ses dalga görseli: Entegrasyon Adımları

Entegrasyon, öncelikle /get-api-key/ sayfasından alınan API anahtarı ile başlar. Bu anahtar, isteklerde "Authorization: Bearer" başlığı altında kimlik doğrulama sağlar.

API anahtarı

Hesap oluşturulduktan sonra panelde görünen anahtarı kopyalayın. Her hesap için tek aktif anahtar vardır; yeni anahtar oluşturmak eskisini anında geçersiz kılar.

  • Anahtarı güvenli ortamda tutun.
  • Yeni anahtar eskiyi hemen iptal eder.

İstek gönderme

POST https://api.rip3.info/v1/audio/speech endpointine JSON body gönderin. Model (tts-1/tts-1-hd), metin (input) ve ses (voice) alanlarını doldurun.

Ses indirme

API yanıtı olarak seçilen formatta (mp3, wav vb.) audio dosyası döner. Bu dosyayı anında oynatın veya kaydedin.

Kullanım Alanları

İçin ses dalga görseli: Kullanım Alanları

Sesli asistanlar ve sohbet botları için TTS API’si, metin girdisini gerçekçi sese dönüştüren altyapıyı sağlar. Bağımsız yazılımcılar, bu API’yi kullanarak kullanıcılarla etkileşimi zenginleştirir ve metin tabanlı sohbetlerin ötesine geçer.

Bu yapı, özellikle mobil ve web tabanlı uygulamalarda doğal bir ses deneyimi sunar. Kullanıcılar, botların yanıtlarını dinleyerek daha akıcı bir iletişim kurar.

Sohbet botları

Sohbet botları, TTS API’si sayesinde metin yanıtlarını sese dönüştürerek kullanıcılarla daha etkileyici bir iletişim kurar. Bu özellik, özellikle mobil uygulamalarda kullanıcı deneyimini artırır.

  • Metin yanıtlarını sese dönüştürme
  • Kullanıcı etkileşimini zenginleştirme
  • Mobil ve web uygulamaları için uygunluk

Sesli asistanlar

Sesli asistanlar, TTS API’si ile doğal sesli yanıtlar üretir. Bu, kullanıcıların asistanlarla daha rahat iletişim kurmasını sağlar ve erişilebilirliği artırır.

  • Doğal sesli yanıtlar
  • Kullanıcı konforunu artırma
  • Erişilebilirlik iyileştirmeleri

Otomasyon

Otomasyon süreçlerinde TTS API’si, metin verilerini sese dönüştürerek iş akışlarını hızlandırır. Bu, özellikle raporlama ve bildirim sistemlerinde kritik öneme sahiptir.

  • İş akışlarını hızlandırma
  • Raporlama ve bildirim sistemleri
  • Metin verilerini sese dönüştürme

Özellikler

İçin ses dalga görseli: Özellikler

Sesli asistan projelerinizde metin seslendirmeyi özelleştirmek için API'nizdeki temel yapı taşlarını doğru ayarlamak kritik öneme sahiptir. Bu özellikler, üretilen sesin hem teknik uyumluluğunu hem de kullanıcı deneyimini doğrudan etkiler.

Hız ayarı

Metin okuma hızını 0.25 ile 4.0 arasında ayarlayabilirsiniz. Bu parametre, sesli asistanınızın konuşma temposunu dinleyiciye göre esnetmek veya kısaltmak için kullanılır.

Format seçimi

Çıktı dosyasını mp3, wav, opus, flac veya pcm olarak seçebilirsiniz. Format tercihi, indirme boyutu ve oynatma uyumluluğunu belirler.

Model seçimi

İki model arasından seçim yapın: tts-1 ve tts-1-hd. Her iki model de aynı motoru kullanır; fiyat açısından fark yoktur (tts-1-hd daha yüksek kalite sunar).

Veri Gizliliği

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

Sistem, gönderdiğiniz metni yalnızca ses dosyasını oluşturmak amacıyla işler ve bu metni eğitim verisi olarak kullanmaz. Bu sayede özel konuşma metinleriniz kalıcı bir şekilde öğrenilmez veya analiz edilmez.

Metin kullanımı

Metin, ses sentezi işlemi tamamlandığında işlevini tamamlar. Sadece faturalandırma amacıyla zaman, karakter sayısı ve durum bilgisi gibi istatistiksel veriler saklanır.

Ses depolama

Üretilen ses dosyaları yanıt olarak size iletilir ve sunucularımızda kalıcı olarak depolanmaz. Bu nedenle, oluşturulan her ses dosyası doğrudan tüketiciye aktarılır.

Özel veri

Güvenlik ve şeffaflık için her ses dosyası, sentetik olduğunu belirten görünmez bir su işareti içerir. Bu sayede içeriğin yapay zeka tarafından üretilmiş olduğu net bir şekilde işaretlenir.

Destek

İçin ses dalga görseli: Destek

Sesli asistan projelerinizde teknik bir sorunla karşılaştığınızda veya API anahtarınızla ilgili bir sorunuz olduğunda doğrudan e-posta ile bize ulaşabilirsiniz. Telefon numarası veya canlı destek hattı bulunmamaktadır; tüm iletişim kanallarımız e-posta üzerinden yürütülür.

E-posta desteği

Destek ekibimizle tek iletişim yolu e-postadır. Telefon numarası veya canlı sohbet özelliği bulunmamaktadır. Sorularınızın en kısa sürede yanıtlanması için lütfen API anahtarınızı ve ilgili hata loglarını e-postanızda belirtiniz.

Dokümantasyon

Entegrasyon rehberimiz ve örnek isteklerimizi /docs/ adresinde bulabilirsiniz. OpenAI SDK uyumlu yapımız sayesinde mevcut kod tabanınızı kolayca adapte edebilirsiniz.

  • Hazır cURL örnekleri
  • Endpoint referansı
  • Hata kodları açıklaması

Hata yönetimi

Sentez başarısız olursa ücret iade edilir. Rate limit (dakikada 60 istek) aşıldığında istekler kuyruğa alınır. HTTP hata kodlarını inceleyerek sorunu tespit edebilirsiniz.

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.

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. IETF RFC 7845: Ogg Opus
  3. LibriVox public-domain audiobooks
  4. LibriTTS-R paper (arXiv 2305.18802)
  5. Tether (USDT)
  6. Creative Commons Attribution 4.0
  7. TRON developer hub: TRC-20
  8. OpenAI API reference: create speech
  9. W3C WAI: making audio and video accessible
  10. FFmpeg documentation
  11. Python documentation
  12. openai-node on GitHub

Sitede daha fazla