Metinleri Sese Dönüştüren Bulut TTS API'si

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

SesliRehber, tıp ekipleri ve hasta rehberleri hazırlayan büyük gruplar için tasarlanmış bulut tabanlı bir metin-okuma API'sidir. Karmaşık tıbbi terminolojiyi doğru ve tutarlı bir şekilde sese dönüştürerek hasta eğitim materyallerinin hazırlanma sürecini hızlandırır. Bu sayfa, API'nin temel işlevselliğini, dil ve ses seçeneklerini, fiyatlandırma modelini ve teknik entegrasyon detaylarını kapsar.

JSON tabanlı istek yapısı ve OpenAI SDK uyumluluğu sayesinde mevcut geliştirme süreçlerinize entegre edebilirsiniz. Karakter başına ücretlendirme, USDT ile yükleme ve hata durumunda iade garantisi gibi şeffaf ödeme modelleri sunarız. Teknik özellikler, hız sınırlamaları, veri gizliliği ve destek süreçlerine ilişkin detaylar aşağıda açıklanmıştır.

Metinleri Sese Dönüştüren Bulut TTS API'si

Sıkça sorulan sorular

Yazı seslendirme API'si nedir?

SesliRehber, bulut tabanlı bir metinden sese (TTS) API'sidir. Metin gönderirsiniz, ses dosyası alırsınız. Tıp ekipleri ve hasta rehberleri için tasarlanmıştır. Karmaşık tıbbi terminolojiyi doğru ve tutarlı şekilde sese dönüştürür. POST isteği ile çalışır. OpenAI SDK uyumludur. Büyük gruplar için yüksek verimlilik sağlar.

TTS API'si nasıl çalışır?

Metni POST isteği ile gönderirsiniz. API, ses dosyasını döndürür. Metin 4096 karakteri geçerse bölünür ve birleştirilir. Gerçek zamanlı hız yaklaşık saniyede 25 karakterdir. Uzun metinler için kuyrukta bekleme olabilir. Başarısız isteklerde ücret alınmaz. API anahtarı ile kimlik doğrulaması yapılır.

Hangi sesler önerilir?

Sesler 8 önceden ayarlanmıştır. Aria, Nova, Luna ve Sage kadın seslerdir. Felix, Milo, Atlas ve Orion erkek seslerdir. Tıbbi içerikler için Sage (sakin, eğitici) veya Atlas (nötr, haber) önerilir. Sesler çok dillidir. Her ses tüm dilleri destekler. Tıbbi terminoloji için net anlatım sunan sesler seçilmelidir.

API'nin dakikada ne kadar istek limiti var?

Anahtar başına dakikada 60 istek limiti vardır. İlk yükleme yapılmadan önce bu oran dakikada 10 istektir. Hız ayarı ve karakter uzunluğu işlem süresini etkiler.

Hangi diller destekleniyor?

23 dil desteklenir: 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, Türkçe. Dil belirtilmezse script'e göre tahmin edilir. Latin alfabesi İngilizce olarak varsayılır. Diğer diller desteklenmez.

Ses dosyaları için hangi formatlar mevcut?

MP3, WAV, Opus, FLAC ve PCM formatları mevcuttur. İsteğe bağlı olarak hız ve dil ayarları yapılabilir. Format seçimi, dosya boyutu ve uyumluluk gereksinimlerine göre yapılır. Ses dosyaları yanıt içinde doğrudan döndürülür. Kalite ve boyut dengesi için format seçimi esastır. Tüm formatlar aynı ses motoru ile üretilir.

Veriler eğitim için kullanılıyor mu?

Girdi metni sadece ses üretimi için kullanılır. Eğitim verisi olarak kullanılmaz. Üretilen ses dosyası yanıtta döndürülür ve saklanmaz. İstek meta verileri (zaman, karakter, durum) faturalandırma için tutulur. Veri gizliliği korunur. Tıbbi hasta rehberleri için veri kullanımı sınırlıdır. Veriler üçüncü taraflarla paylaşılmaz.

API anahtarını nasıl yenileyebilirim?

Hesap panelinden yeni anahtar oluşturabilirsiniz. Eski anahtar anında geçersiz olur. Her hesap için tek aktif anahtar vardır. Anahtar yenileme, mevcut istekleri kesintiye uğratmaz. Güvenlik için düzenli yenileme önerilir. Anahtar, yetkilendirme başlığında taşınır. Yeni anahtar oluşturulduktan sonra eski anahtarla yapılan istekler reddedilir.

Hangi hata durumlarında ücret iadesi yapılır?

Sentez başarısız olursa ücret iade edilir. İade tam olarak yapılır. Başarılı isteklerde ücret alınır. Hata durumları API yan kodlarından anlaşılır. İade, otomatik olarak hesap bakiyesine işlenir. Kullanıcı müdahalesi gerekmez. Hata logları inceleme için tutulur. Ücret iadesi, başarısız sentez işlemleri için geçerlidir.

USDT ile yükleme nasıl yapılır?

Yükleme sadece TRON ağı (TRC-20) üzerinden USDT ile yapılır. Minimum yükleme tutarı 5 USD'dir. Transfer sonrası otomatik kredilendirme yapılır. İşlem dakikalar içinde tamamlanır. Kart, PayPal veya fatura seçeneği yoktur. Bakiye süresiz geçerlidir. Yükleme sayfasından adres alınır. TRC-20 uyumlu cüzdanlar kullanılmalıdır.

Karakter sınırı nedir?

İstek başına maksimum 4096 karakter sınırı vardır. Boşluklar ve noktalama işaretleri karakter sayılır. Uzun metinler istemci tarafında parçalara bölünmelidir. Ses dosyaları birleştirilir. Karakter başı fiyat 0.00001 USD'dir. 1 milyon karakter 10 USD'dir. Hız ayarı karakter sayısını etkilemez. Metin uzunluğu işleme süresini artırır.

Hız ayarı ne kadar etkilidir?

Hız 0.25 ile 4.0 arasında ayarlanabilir. Varsayılan hız 1.0'dır. Hız artışı, ses süresini kısaltır. Hız azaltımı, süreyi uzatır. Hız ayarı, ses dosyasının uzunluğunu doğrudan etkiler. Karakter başı ücret değişmez. Hız, ses tonunu değiştirmez.

Dil seçimi nasıl yapılır?

Dil, isteğe bağlı ISO kodu ile belirtilir. Belirtilmezse script'e göre tahmin edilir. Latin alfabesi İngilizce olarak varsayılır. Türkçe içerikler için dil kodu belirtilmelidir. Sesler tüm dilleri destekler. Dil seçimi, telaffuz kalitesini artırır. Yanlış dil seçimi, yanlış telaffuza neden olabilir. Dil kodu, JSON isteğinde gönderilir.

İlk istek

curl

curl https://api.playpaksuper.com/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.mp3

API İşlevselliği ve Kullanım

İçin ses dalga görseli: API İşlevselliği ve Kullanım

SesliRehber, tıbbi terminoloji içeren karmaşık metinleri yüksek doğrulukla sese dönüştüren bulut tabanlı bir API sunar. Hastalar için hazırlanan eğitim materyallerinin ve rehberlerin seslendirme sürecini otomatize ederek büyük ekiplerin iş akışını hızlandırır.

Geleneksel stüdyo kayıtlarına kıyasla daha hızlı ve tutarlı bir üretim sağlar. Sistem, tıbbi prosedürler veya hasta hakları gibi teknik içerikleri doğru telaffuzla işleyerek ekip içi standartları korur.

Metni sese çevirme endpoint'i

Metni sese çevirme endpoint'i

Ana fonksiyon, POST https://api.playpaksuper.com/v1/audio/speech endpoint'i üzerinden çalışır. Gönderilen JSON verisine göre metin, belirtilen model ve ses ayarlarına göre işlenir.

İstek başarılı olduğunda, sunucu doğrudan ses dosyasını döndürür. Başarısız durumlarda, ücret iade edilir ve hata detayı döndürülür.

  • Tek bir endpoint üzerinden tüm ses üretimi.
  • JSON formatında basit veri alışverişi.
  • Anlık ses dosyası döndürme.

JSON tabanlı istek yapısı

İstek gövdesi, OpenAI speech endpoint'i ile aynı formatta hazırlanır. Bu yapı, model, input, voice, response_format ve speed alanlarını içerir.

Tıbbi metinlerde karakter sınırı 4096 ile sınırlıdır. Uzun metinler, istemci tarafında parçalara bölünerek ardışık olarak gönderilmelidir.

  • Model: tts-1 veya tts-1-hd
  • Ses: 8 hazır preset (örn. aria, atlas)
  • Format: mp3, wav, opus, flac, pcm
  • Hız: 0.25 – 4.0 arası

Kurulum gerektirmeyen bulut altyapısı

API, herhangi bir sunucu kurulumu veya özel donanım gerektirmez. HTTP istekleri ile doğrudan entegre edilir.

Tıbbi yazılım ekipleri, mevcut veritabanlarındaki metinleri API'ye göndererek anında ses dosyası elde eder. Altyapı yönetimi tamamen platform tarafından sağlanır.

Desteklenen Diller ve Sesler

İçin ses dalga görseli: Desteklenen Diller ve Sesler

Sistem, tıbbi terminoloji içeren metinlerin doğru telaffuzunu sağlamak amacıyla 23 farklı dilde ses sentezi sunar. Bu kapsam, uluslararası hasta rehberleri ve çok dilli eğitim materyalleri hazırlayan büyük ekipler için dil uyumunu garanti eder.

Her ses, kuru tıbbi verilerin doğal ve anlaşılır bir tonda iletilmesini sağlar. Sesler, tıbbi okuyucuların kullanımına uygun şekilde tasarlanmış hazır presetlerdir.

23 dil desteği

API şu dilleri destekler: 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. Sesler tüm desteklenen dillerde kullanılabilir; belirli bir dil seçilmezse metnin script'inden tahmin edilir.

Vietnamca, Endonezce, Tayca, Ukraynaca, Romence, Çekçe, Bengalce ve listede yer almayan diğer diller desteklenmez. Tıbbi metinlerde dil belirleyicisi olarak ISO kodu kullanılması önerilir.

8 hazır ses seçeneği

Kullanıcılar, metnin tonuna ve hedef kitlesine göre sekiz farklı ses arasından seçim yapabilir. Sesler, lisanslı kayıtlara dayalıdır ve yapay zeka tarafından sentezlenmiştir.

Dişli sesler: Aria (sıcak, net anlatıcı), Nova (parlak, pozitif), Luna (yumuşak, hikaye anlatıcı), Sage (sakin, eğitici). Erkek sesler: Felix (enerjik, tanıtım), Milo (samimi, konuşma), Atlas (nötr, haber), Orion (derin, belgesel).

Dil tahmini ve manuel ayar

API, language alanı boş bırakıldığında metnin script'ine bakarak dili otomatik tahmin eder. Latin alfabesi kullanan metinler varsayılan olarak İngilizce olarak kabul edilir. Türkçe veya diğer diller için Latin alfabesi kullanılsa bile, doğru telaffuz için language parametresinin açıkça belirtilmesi gerekir.

Tıbbi terminoloji içeren karmaşık metinlerde dil hatası riskini azaltmak için ISO dil kodunu (tr, en, de vb.) istek gövdesinde belirtin.

Fiyatlandırma ve Ödeme

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

Sistem, karakter başına sabit bir ücretlendirme modeli ile çalışır. Her 1.000 karakter için 0,01 $ ödenir; boşluklar ve noktalama işaretleri karakter sayısına dahildir. Başarısız isteklerde ücret tam olarak iade edilir.

Toplam bakiye süresiz olarak geçerlidir ve her türlü aylık plana veya minimum harcama zorunluluğuna tabi değildir. Hesap oluşturulduğunda Google ile giriş yapanlara 7 gün geçerli 0,50 $ deneme kredisi tanınır.

Karakter başına ücretlendirme

Fiyatlandırma şeffaf ve doğrudan kullanım üzerinden hesaplanır. 1 milyon karakter başına 10 $ ücret alınır. Uzun metinler istemci tarafında parçalara bölünerek ardışık olarak gönderilmelidir.

  • 1.000 karakter = 0,01 $

USDT ile yükleme

Yüklemeler sadece TRON ağı (TRC-20) üzerinden USDT ile kabul edilir. Minimum yükleme tutarı 5 $'dır. Transferler genellikle birkaç dakika içinde otomatik olarak bakiyeye işlenir.

Kredi kartı, PayPal, fatura veya abone olma seçeneği mevcut değildir. Bakiye süresiz olarak saklanır.

  • TRC-20 USDT ile yükleme
  • Minimum tutar: 5 $

Hata durumunda iade garantisi

Sentezleme işlemi başarısız olursa, kullanılan karakterler için ücret alınmaz ve bakiye tam olarak iade edilir. Bu garanti, hata durumunda ek bir onay gerektirmez.

Teknik Özellikler

İçin ses dalga görseli: Teknik Özellikler

API, MP3, WAV, OPUS, FLAC ve PCM formatlarında ses çıktısı sunar. İhtiyaca göre en uygun codec'i seçerek dosya boyutu ve kalite arasında denge kurun.

Hız parametresi 0.25 ile 4.0 arasında ayarlanabilir. Metin uzunluklarında tutarlılık için dil kodunu manuel olarak belirtin.

Format seçenekleri (MP3, WAV, vb.)

Çıktı formatı response_format alanıyla belirlenir. MP3 ve OPUS dosya boyutunu küçültürken WAV ve FLAC yüksek kaliteli lossless ses sağlar. PCM ham veri akışı için idealdir.

  • MP3: Geniş uyumluluk, düşük dosya boyutu
  • WAV: Lossless, yüksek kaliteli ses
  • OPUS: Yüksek verimlilik, düşük bant genişliği
  • FLAC: Kayıpsız sıkıştırma
  • PCM: Ham dijital veri

Hız ayarı ve dil seçimi

Seslendirme hızı speed parametresiyle 0.25x ile 4.0x arasında ayarlanabilir. Dil kodu belirtilmezse sistem script'e göre tahmin yürütür; Latin alfabeli Türkçe metinler için language parametresi ile kesin dil belirleyin.

  • Hız aralığı: 0.25 - 4.0
  • Dil kodu: Opsiyonel ISO kodu

Karakter sınırı ve işleme süresi

Her istek maksimum 4096 karakter destekler. Uzun metinleri parçalara bölüp ses dosyalarını birleştirin. İşleme süresi yaklaşık gerçek zamanlıdır; saniye başına 25 karakter işlenir.

  • Maks. karakter: 4096
  • İşleme: ~25 karakter/saniye
  • Kuyruk: Yoğunlukta bekleme süresi

Veri Güvenliği ve Gizlilik

İçin ses dalga görseli: Veri Güvenliği ve Gizlilik

Girdi olarak gönderilen metinler, yalnızca ses dosyası üretim aşamasında kullanılır. İşlem tamamlandığında, bu metinler eğitim verisi olarak kaydedilmez veya gelecekte farklı modellerde kullanılmak üzere depolanmaz.

API'ye gönderilen ham veri, istemci tarafında kalır veya geçici olarak işlenir.

Girdi verisinin kullanımı

Sistem, gönderdiğiniz metni sadece ses dosyasına dönüştürmek için kullanır. Bu metinler, model eğitimi veya gelişim için veri havuzuna eklenmez. Tıbbi terimler ve hasta rehberleri, yalnızca anlık işleme için işlenir.

Oluşturulan seslerin depolanması

API yanıtı olarak döndürülen ses dosyaları, sunucularımızda kalıcı olarak saklanmaz. Dosyalar, istemciye iletildikten sonra genellikle geçici bellekte tutulur ve kalıcı bir veritabanında depolanmaz.

Faturalandırma verileri

Doğru faturalandırma için istem zamanı, karakter sayısı ve istek durumu gibi meta veriler kaydedilir. Bu veriler, sadece hesap bakiyesi ve kullanım istatistiklerini göstermek için saklanır.

Veri Güvenliği ve Gizlilik

API Entegrasyonu

İçin ses dalga görseli: API Entegrasyonu

API'niz, OpenAI Speech endpoint'iyle aynı JSON yapısını kullanır; bu da mevcut OpenAI SDK'larını base_url değişikliği ile doğrudan kullanabilmenizi sağlar.

Klinik notlar veya hasta rehberleri gibi karmaşık terminoloji içeren metinleri, standart HTTP istekleri veya SDK'lar aracılığıyla ses dosyasına dönüştürmek için tek bir endpoint yeterlidir.

OpenAI SDK uyumluluğu

Resmi OpenAI SDK'larını, base_url parametresini https://api.playpaksuper.com/v1 olarak değiştirerek kullanabilirsiniz. Bu yapı, istek şekli ve hata yönetimi tutarlılığı sağlar.

Node.js, Python veya Go gibi dillerde SDK'nızın varsayılan konfigürasyonunu güncelleyerek entegrasyonu dakikalar içinde tamamlayabilirsiniz.

Temel istek örneği

POST isteği, https://api.playpaksuper.com/v1/audio/speech adresine gönderilir. JSON gövdesinde model (tts-1 veya tts-1-hd), input (metin) ve voice (örneğin 'nova' veya 'atlas') alanları tanımlanır.

Örnek bir istek, 4096 karakterlik bir hasta bilgilendirme metnini MP3 formatında, 1.0 hızında, İngilizce dil belirterek işler.

  • Endpoint: POST https://api.playpaksuper.com/v1/audio/speech
  • Gövde: {"model": "tts-1", "input": "Metin", "voice": "nova", "response_format": "mp3"}

Kimlik doğrulama yöntemi

Her istek, Authorization: Bearer tts-... başlığı altında, hesabınıza ait benzersiz API anahtarı ile doğrulanır. Anahtar, /get-api-key/ sayfasında görüntülenebilir.

Anahtar yenilendiğinde eski anahtar anında geçersiz olur; bu da güvenlik açıklarında hızlı müdahale imkanı tanır.

Hız Sınırlamaları

İçin ses dalga görseli: Hız Sınırlamaları

API kullanımınızın tutarlılığı ve önbellek verimliliği için Dakikada 60 istek limiti geçerlidir. Bu limit, her API anahtarı için ayrı olarak hesaplanır ve yüksek hacimli tıbbi terminoloji işlemlerinde bant genişliği yönetimini kolaylaştırır.

İlk yükleme öncesi limit olarak Dakikada 10 istek ile başlarsınız. USDT (TRC-20) ile yapılan yüklemeler genellikle dakikalar içinde onaylanır ve limitler anında yükselir.

Dakikada 60 istek limiti

Her API anahtarı için Dakikada 60 istek limiti uygulanır. Bu kısıtlama, sunucu yükünü dengeler ve uzun metinlerin parçalara bölünerek işlenmesi sırasında bile tutarlı bir sonuç süresi sağlar.

İlk yükleme öncesi limit

Yeni hesaplar veya henüz yükleme yapılmamış hesaplar için limit Dakikada 10 istek olarak ayarlanır. Bu, sistem kaynaklarının aşırı kullanımını önler ve yüklemenin onaylanmasını beklerken API erişiminizi kısıtlar.

Kuyruk sistemi çalışması

Talepler sıraya alınarak işlenir. Bu sistem, taleplerin sırasıyla işlendiğini ve yoğunlukta bekleme süresi oluşabileceğini gösterir. Kısa ifadeler birkaç saniye sürerken, uzun metinler gerçek zamanlı hızda işlenir.

  • Talepler sırasıyla işlenir.
  • Yüksek trafikte kuyruk bekleme süresi artabilir.
  • Başarısız isteklerde kuyruk etkilenmez.

Hata Ayıklama ve Destek

İçin ses dalga görseli: Hata Ayıklama ve Destek

API hataları durumunda karakter ücreti iade edilir; sistem bakiyenizi otomatik olarak günceller. Girdi metni 4096 karakter sınırını aştığında ses dosyası üretilmez ve ek ücret alınmaz.

Başarısız istekler

Sentez işlemi sırasında teknik bir sorun oluşursa, ilgili karakter miktarı hesabınıza iade edilir. Bu iade işlemi otomatik gerçekleşir ve faturalandırma geçmişinizde görünür.

  • Başarısız istekler ücretsizdir.
  • Bakiye otomatik güncellenir.

E-posta desteği

Teknik destek yalnızca e-posta üzerinden sağlanır. Telefon numarası veya canlı sohbet bulunmamaktadır. Detaylı yanıtlar için destek adresine erişebilirsiniz.

Hızlı anahtar yenileme

API anahtarınızı istediğiniz zaman yenileyebilirsiniz. Eski anahtar anında geçersiz hale gelir; böylece yetkisiz kullanımlara karşı hesabınız korunur.

Genel Bakış

İçin ses dalga görseli: Genel Bakış

Sistem, tıbbi terminoloji içeren uzun metinleri karakter sınırına göre otomatik bölüp birleştirerek kesintisiz ses dosyası oluşturur. Her istek, API üzerinden doğrudan işlenir ve sonuçlar anlık olarak iletilir.

Mevcut özellikler

API, dört farklı ses formatı (mp3, wav, opus, flac, pcm) ve 0.25–4.0 arası hız ayarı sunar. Metinler, karakter sayısını aşmadan istemci tarafında parçalara bölünür ve ardışık olarak gönderilir.

  • Dört ses formatı ve hız ayarı.
  • Otomatik metin bölme ve birleştirme.
  • 23 dil desteği ve 8 hazır ses.

Desteklenmeyen diller

Vietnamca, Endonezce, Tayca, Ukraynaca, Romence, Çekçe ve Bengalce gibi diller şu anda desteklenmemektedir. Listede olmayan diller için dil kodu belirtilse bile ses kalitesi garanti edilmez.

Sık sorulan sorular

Metinler eğitim için mi kullanılır? Hayır, girdi verisi yalnızca ses üretiminde kullanılır ve eğitim verisi olarak kaydedilmez. Ses dosyaları yanıt olarak iletilir ve sunucuda saklanmaz.

8 sesi dinleyin

Aşağıdaki her örnek, aynı cümle bu API tarafından üretilmiştir. Bu özellik, içeriklerin kaynağını doğrulamak ve tıbbi materyallerin bütünlüğünü korumak 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. MDN: Web Speech API
  3. TRON developer hub: TRC-20
  4. openai-python on GitHub
  5. Python documentation
  6. LibriTTS-R paper (arXiv 2305.18802)
  7. ISO 639 language codes
  8. Tether (USDT)
  9. FFmpeg documentation
  10. LibriTTS-R corpus (OpenSLR 141)
  11. openai-node on GitHub
  12. Node.js documentation

Sitede daha fazla