Sıkça sorulan sorular
Metin ses dosyasına nasıl dönüşür?
Metni POST isteği ile https://api.55ff.info/v1/audio/speech endpointine gönderirsiniz. JSON body'de model, input metni, ses karakteri ve dil belirtirsiniz. API, metni işleyerek istediğiniz formatta (mp3, wav vb.) ses dosyasını döner. İstekler dakikada 60 hızında işlenir.
İnsan sesine ne kadar yakın?
Sesler, CC BY 4.0 lisanslı LibriTTS-R veriseti ve LibriVox seslendirmelerinden türetilmiştir. Her dosya, sentetik olduğunu belirten görünmez bir su taşıma işaretine sahiptir. Doğallık, kullanılan ses presetinin (örneğin Aria veya Luna) özelliklerine bağlıdır; gerçek insan seslerinin birebir kopyası değildir.
Hangi dilde seslendirme yapılabilir?
API, Arapça, Çince, Danca, Almancaca, İngilizce, İtalyanca, Japonca, Korece, Rusça, İspanyolca ve 13 dil daha dahil olmak üzere toplam 23 dili destekler. Sesler tüm dillerde sorunsuz çalışır. Desteklenmeyen diller arasında Vietnamca, Endonezce ve Tayca bulunur. Dil kodunu belirtmezseniz sistem varsayılan olarak İngilizce varsayar.
Seslendirme süresi ne kadar sürer?
Uzun metinlerde ses üretimi yaklaşık gerçek zamanlıdır; saniyede 25 karakter işlenir. Kısa ifadeler birkaç saniye sürebilir. İstekler sırayla işlendiğinden yoğunlukta kuyruk bekleme süresi oluşabilir. Dakikada 60 istek limiti vardır ve bu limit aşımında işlemler bekletilebilir.
Metin içindeki özel karakterler nasıl işlenir?
Metin, karakter sayımı için boşluklar ve noktalama işaretleriyle birlikte değerlendirilir. Özel karakterler veya Unicode desteği API tarafından doğrudan işlenir. 4096 karakterlik sınırı aşan metinler, istemci tarafında parçalara bölünerek tek tek gönderilmeli ve ses dosyaları birleştirilmelidir.
Seslendirme sırasında mola verilebilir mi?
API, anlık kesme veya duraklatma (pause) desteği sunmaz. Metin 4096 karakteri geçtiğinde, metni parçalara bölerek istek göndermeniz gerekir. Bu parçaların ses dosyalarını kendi uygulamanızda birleştirmeniz gerekir. SSML etiketleri veya kesme komutları mevcut değildir.
Birden fazla ses karakteri kullanılabilir mi?
Her istek tek bir ses karakteriyle (örn. Luna, Felix) sınırlıdır. Farklı karakterler kullanmak için ayrı ayrı API istekleri gönderip dönen ses dosyalarını birleştirmeniz gerekir. 8 preset (Aria, Nova, Luna, Sage, Felix, Milo, Atlas, Orion) arasından seçim yapabilirsiniz.
Seslendirme kalitesi düşükse ne olur?
Kalite, seçilen ses presetine ve metnin okunabilirliğine bağlıdır. API, ses kalitesini anlık olarak iyileştirme veya yeniden deneme seçeneği sunmaz. Ancak, sentez işlemi başarısız olursa ücret iade edilir ve karakter harcanmaz. Kalite garantisi veya SLA bulunmamaktadır.
Ses dosyaları indirilebilir mi?
Evet, API yanıtında üretilen ses dosyası doğrudan döndürülür. Dosyalar sunucuda kalıcı olarak saklanmaz; yalnızca faturalandırma için istek meta verileri (zaman, karakter sayısı) tutulur. İndirme işlemi, API yanıtını alan istemci uygulamanız tarafından gerçekleştirilir.
API'yi mobil uygulamada kullanabilir miyim?
API, standart HTTP istekleri ile çalışır. Resmi bir mobil SDK olmamasına rağmen, OpenAI SDK'sını base_url değiştirerek veya doğrudan HTTP istekleri kullanarak herhangi bir mobil uygulamadan (iOS, Android) kullanabilirsiniz. Auth başlığı ile API anahtarınızı doğrulamanız yeterlidir.
Seslendirme sırasında müzik eklenebilir mi?
API, arka plan müziği veya ses efektleri ekleme özelliği sunmaz. Sadece metnin seslendirilmiş halini döner. Müzik eklemek için dönen ses dosyasını kendi düzenleme aracınızda veya uygulamanızda işlemeniz gerekir. Bu özellik mevcut değildir.
Metin içindeki alıntılar nasıl seslendirilir?
Alıntı işaretleri veya tırnaklar, ses tonunu veya duraklamayı otomatik olarak değiştirmez. Metin, belirlenen ses karakterinin genel tonunda okunur. Özel vurgu veya tonlama için SSML desteği yoktur. Alıntıların okunuşu, metnin kendisi ve ses presetinin tarzı tarafından belirlenir.
Sayılar nasıl okunur?
Sayılar, metnin içindeki karakterler olarak işlenir ve ses karakterinin standart telaffuzuna göre okunur. Özel sayı sözlüğü veya vurgu ayarı yoktur. Örneğin, '100' sayısı 'yüz' olarak okunur. Doğru okunuş için metnin dilini doğru belirtmeniz önemlidir.
Tarihler ve saatler nasıl telaffuz edilir?
Tarih ve saat formatları, metnin diline göre otomatik olarak işlenir. Desteklenen dillerde standart okuma kuralları uygulanır. Özel tarih formatları için SSML desteği bulunmadığından, metni doğal dil cümlesi olarak yazmanız en iyi sonucu verir. Dil kodunu açıkça belirtin.
API Temel İşleyişi
MasalSes API'si, basit bir HTTP POST isteği ile çalışır. Metni JSON formatında gönderir, karşılığında hazır ses dosyasını alırsınız. İstek gövdesinde model, metin, ses seçimi ve dil gibi parametreler belirlenir.
Sistem, girdi metnini işleyerek yüksek kaliteli ses dosyasına dönüştürür. Bu sayede masal kitapları veya hikaye metinlerinizi ses dosyalarına dönüştürebilirsiniz.
JSON tabanlı POST isteği
API, POST https://api.55ff.info/v1/audio/speech endpoint'ine JSON formatında veri gönderilmesini bekler. İstek içinde input (metin), voice (ses profili) ve model gibi alanlar yer alır. Metin 4096 karakteri geçmemelidir.
OpenAI SDK uyumluluğu
API isteği, OpenAI speech endpoint yapısıyla aynı şekildedir. Bu sayede mevcut OpenAI SDK'larını base_url parametresini https://api.55ff.info/v1 olarak değiştirerek doğrudan kullanabilirsiniz.
Ses dosyası dönüşümü
Gönderilen metin, seçilen ses profili ve dil parametrelerine göre sentezlenir. Sonuç olarak MP3, WAV, OPUS, FLAC veya PCM formatında ses dosyası döndürülür.
Desteklenen Diller ve Sesler
MasalSes API, 23 farklı dilde metinden sese dönüşümü sağlar. Bu çoklu dil desteği, yayıncıların masal ve hikaye kitaplarını farklı dillerde yayınlamalarını sağlar.
Her ses, lisanslı kayıtlara dayalıdır ve sentetik konuşmayı belirten görünmez bir su filigranı taşır. Bu sayede, üretilen her ses dosyasının yapay zeka ile üretildiği teknik olarak işaretlenir.
23 dil desteği
API, Arapça, Çince, Danca, Hollandaca, İ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 dahil olmak üzere 23 dili destekler. Bu dillerden herhangi biri için ses sentezi gerçekleştirebilirsiniz.
Desteklenmeyen diller arasında Vietnamca, Endonezce, Tayca, Ukraynaca, Romence, Çekçe, Bengalce ve diğerleri bulunur. Listede yer almayan diller için henüz sentez imkanı sunulmaz.
- Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish
8 farklı ses profili
Metinleri 8 farklı ses profiline dönüştürebilirsiniz: Aria, Nova, Luna, Sage, Felix, Milo, Atlas ve Orion. Bu sesler, masal anlatımı, eğitim materyalleri ve promosyon içerikleri için uygun tonlarda hazırlanmıştır.
Her ses, farklı bir ton ve tarz sunar. Örneğin, Aria sıcak ve net bir anlatıcı tonuna sahipken, Orion daha derin ve belgesel tarzında seslendirme sağlar. Felix ise enerjik ve tanıtım odaklıdır.
- Aria (warm, clear narrator), Nova (bright, upbeat), Luna (soft, storytelling), Sage (calm, instructional), Felix (energetic, promo), Milo (friendly, conversational), Atlas (neutral, news), Orion (deep, documentary)
Dil otomatik algılama
Dil parametresi belirtilmediğinde, sistem metnin script'ine dayanarak dili otomatik olarak tahmin eder. Latin alfabesiyle yazılmış metinler varsayılan olarak İngilizce olarak işlenir.
Türkçe, Almanca veya Fransızca gibi diğer Latin tabanlı diller için doğru sentez elde etmek adına language parametresini açıkça belirtmeniz önerilir. Bu, dilin yanlış algılanmasını önler ve daha doğal bir ses üretir.
Teknik Özellikler
MasalSes API'si, gönderilen JSON tabanlı istekler üzerinden çalışır ve OpenAI SDK'larının base_url değişikliğiyle doğrudan kullanılabilmesini sağlar. Bu yapı, geliştiricilerin mevcut altyapılarını minimal çabayla entegre etmesine olanak tanır.
4096 karakter sınırı
Her API isteği, en fazla 4096 karakterlik metin bloklarını işler. Bu sınırın aşılması durumunda, uzun metinlerin parçalara bölünmesi ve ses dosyalarının birleştirilmesi gerekir.
MP3, WAV, OPUS, FLAC, PCM
Ses çıktısı, proje gereksinimlerinize göre MP3, WAV, OPUS, FLAC veya PCM formatlarında oluşturulabilir.
Hız ayarı (0.25-4.0x)
Seslendirme hızı, 0.25 ile 4.0 arasında isteğe göre ayarlanabilir. Bu esneklik, masal anlatımlarının temposunu veya eğitim materyallerinin netliğini optimize etmek için kullanılır.
Fiyatlandırma ve Ödeme
MasalSes API'si, metin karakteri başına hesaplanan şeffaf bir ücretlendirme modeli sunar. Her 1 milyon karakter için $10 ödersiniz; boşluklar ve noktalama işaretleri de karakter sayısına dahil edilir. Bu model, kısa cümlelerden uzun hikaye kitaplarına kadar her türlü içerik üretimi için maliyet optimizasyonu sağlar.
$10 / 1 milyon karakter
Tahakkuk, istek başına değil, gönderilen karakter sayısına göre gerçekleşir. Örneğin, 1.000 karakterlik bir metin için 0,01$ ödersiniz. Bu oran, yüksek hacimli e-kitap veya eğitim materyali üretiminde maliyetleri tahmin edilebilir kılar.
TRC-20 USDT ile yükleme
Bakiye yükleme işlemi yalnızca TRON ağı (TRC-20) üzerinden USDT ile yapılır. Minimum yükleme tutarı $5'tir. Transferler genellikle birkaç dakika içinde otomatik olarak bakiyenize işlenir. Faturalandırma, vergi veya abonelik sistemleri ile karmaşık değildir; bakiyeniz süresiz olarak geçerlidir.
- Yalnızca TRC-20 USDT
- Minimum $5 yükleme
- Otomatik ve hızlı işleme
Başarısız istekler ücretsiz
API'nin işleme sırasında hata vermesi durumunda, harcanan karakterler için ücret alınmaz. Ödenen tutar hesabınıza iade edilir. Bu özellik, teknik aksaklıklar sırasında beklenmedik faturalaşma riskini ortadan kaldırır.
Entegrasyon Adımları
Entegrasyon süreci, hesap panelinden API anahtarınızı alarak başlar. Anahtarı kopyaladıktan sonra OpenAI SDK veya HTTP isteklerinizde base_url parametresini https://api.55ff.info/v1 olarak yapılandırmanız yeterlidir.
API anahtarı oluşturma
/get-api-key/ sayfasında Google veya e-posta ile giriş yaparak tekil bir API anahtarına sahip olursunuz. Bu anahtarı Authorization: Bearer başlığı altında göndererek isteklerinizi doğrulayın.
- Tek aktif anahtar ile çalışılır.
- Yeni anahtar çıkardığınızda eskisi anında geçersiz olur.
Base URL ayarı
SDK yapılandırmanızda base URL'i https://api.55ff.info/v1 olarak ayarlayın. Bu ayar, isteklerinizi doğru uç noktalara yönlendirir.
İlk ses isteği gönderimi
POST /v1/audio/speech endpointine model, ses ve metin içeren JSON isteği gönderin. API, metni ses dosyasına dönüştürerek yanıt döndürür.
- Model: tts-1 veya tts-1-hd.
- Format: mp3, wav, opus, flac, pcm.
Karakteristik Özellikler
MasalSes API'si, metinleri yüksek kaliteli ses dosyalarına dönüştürerek yayıncıların üretim süreçlerini otomatikleştirir. API, OpenAI SDK yapısıyla uyumlu çalışarak entegrasyonu kolaylaştırır.
Ürün, sadece ses üretme odaklıdır. Ek özellikler veya karmaşık yapılar sunmaz; basit, güvenilir ve ölçeklenebilir bir çözüm sunar.
Sentezli ses işareti
Her üretilen ses dosyası, dinleyici tarafından algılanamayan bir su işareti içerir. Bu işaret, sesin yapay zeka tarafından sentezlendiğini doğrular.
Metin bölme ve birleştirme
Uzun metinler otomatik olarak 4096 karakterlik parçalara bölünür. Her parça ayrı ayrı işlenir ve final ses dosyasında sorunsuzca birleştirilir.
Bu süreç, e-kitaplar veya uzun hikayeler için ideal bir çözüm sunar. Metin sınırlarını manuel olarak yönetmenize gerek kalmaz.
Gerçek zamanlıya yakın işleme
Ortalama olarak saniyede 25 karakter işleme hızı sağlanır. Bu hız, uzun metinlerde neredeyse gerçek zamanlı bir deneyim sunar.
Kısa ifadeler birkaç saniye sürebilir. Yüksek yük altında istekler sıraya alınabilir, bu da işleme süresini etkileyebilir.

Kullanım Senaryoları
MasalSes API'si, yayıncıların uzun metinleri kısa sürede profesyonel ses dosyalarına dönüştürmesini sağlar. Belirli karakter sınırlarına uyarak metinleri parçalara böler ve birleştirir; böylece e-kitaplar veya eğitim materyalleri için kesintisiz ses içerikleri üretilir.
API, metinleri doğrudan ses dosyasına dönüştürerek üretim süreçlerini otomatikleştirir. Yayıncılar, hazır ses profillerini kullanarak hızlıca içerik hazırlayabilir ve farklı platformlar için optimize edilmiş ses dosyaları elde edebilir.
E-kitap seslendirmeleri
E-kitap yayıncıları, uzun metinleri 4096 karakterlik parçalara bölerek seslendirme yapabilir. Bu sayede büyük hacimli kitaplar bile sorunsuz şekilde dijital audio içeriğe dönüştürülebilir.
Eğitim içerikleri
Eğitim materyalleri için sesli anlatım, öğrenme sürecini destekler. API'nin farklı dil ve ses seçenekleri sayesinde, öğrencilere hitap eden uygun tonlarda içerikler üretebilirsiniz.
Otomatik yanıt sistemleri
Müşteri hizmetleri veya bilgi sistemlerinde, metinlerin anlık olarak sese dönüştürülmesi kullanıcı deneyimini artırır.
Teknik Gereksinimler
MasalSes API'si ile çalışmaya başlamak için temel bir internet bağlantısına ihtiyacınız vardır. API, metinleri bulut tabanlı olarak işler ve ses dosyalarını doğrudan sunucularımız üzerinden iletir.
Entegrasyon sürecinde tek teknik gereksinim, JSON formatında veri gönderip alabilen standart bir HTTP istemcisidir. Herhangi özel bir yazılım veya eklenti kurmanıza gerek yoktur.
İnternet bağlantısı
API'nin bulut tabanlı yapısı nedeniyle, metin gönderimi ve ses dosyası alımı için istikrarlı bir internet bağlantısı gereklidir. Sunucu yanıt süreleri, genel ağ durumuna bağlı olarak değişiklik gösterebilir.
API anahtarı
Hizmeti kullanmaya başlamak için /get-api-key/ sayfasından hesabınızı oluşturmalı ve API anahtarınızı almalısınız. Bu anahtar, isteklerinizde kimlik doğrulama için Authorization: Bearer başlığı altında kullanılmalıdır.
Her hesap için aktif olan tek bir anahtar bulunur. Yeni bir anahtar oluşturduğunuzda, eski anahtar anında geçersiz hale gelir.
JSON işleme kapasitesi
API, verileri JSON formatında kabul eder. İstemci tarafınızda basit bir HTTP POST isteği hazırlamanız yeterlidir. OpenAI SDK'larını base_url'i değiştirerek de kullanabilirsiniz.
İstek gövdesinde model, input (metin), voice ve response_format alanlarını belirtmeniz gerekir. Cevap olarak ses dosyası döner.
Sınırlamalar
API'nin sunduğu esnek yapının yanı sıra, kullanım senaryolarınızı planlarken dikkat etmeniz gereken birkaç teknik sınır bulunmaktadır. Bu sınırlar, sistemin verimli çalışmasını sağlar ve beklenmedik hata almamanız için önemlidir.
Karakter sınırı
Her bir API isteği maksimum 4096 karakter içerebilir. Daha uzun masal metinlerini seslendirmek için metni bu sınırı aşmayacak şekilde parçalara bölmelisiniz. Her parça ayrı bir istek olarak gönderilir ve sonuçlar birleştirilerek tek bir dosya elde edilir.
Format seçenekleri
Ses dosyaları MP3, WAV, OPUS, FLAC veya PCM formatlarında alınabilir. İhtiyacınıza en uygun ses kalitesini ve dosya boyutunu seçebilirsiniz. SSML desteği bulunmamaktadır.
İşleme süresi
Uzun metinlerde ses üretimi genellikle gerçek zamanlı hızdadır; ancak kısa cümleler birkaç saniye sürebilir. Yoğunluk durumunda istekler sıraya alınabilir. Dakikada 60 istek limiti, yüksek trafikte bekleme sürelerine neden olabilir.
Veri Güvenliği
MasalSes API'si, girdi metnini yalnızca ses dosyasına dönüştürmek için kullanır ve eğitim amaçlı depolamaz. Oluşturulan ses dosyaları yanıt olarak iletilir ve sunucularda saklanmaz.
Sadece faturalandırma için gerekli istatistikler saklanır. Metinleriniz gizliliğinize saygı duyularak işlenir.
Metin işleme gizliliği
Gönderdiğiniz masal ve hikaye metinleri, ses sentezi işlemi tamamlandığında kullanımdan kalkar. Verileriniz üçüncü taraflarla paylaşılmaz veya yapay zeka modellerinin eğitilmesi için kullanılmaz.
Veri saklama politikası
API, oluşturduğunuz ses dosyalarını kalıcı olarak depolamaz. İstek tamamlandığında ses dosyası sunucuda kalıcı bir yer kaplamaz ve kullanıcıya iletilir.
Kullanım verileri
Faturalandırma ve limit takibi amacıyla; istek zamanı, karakter sayısı ve durum bilgileri saklanır. Bu veriler yalnızca hesabınızın doğru yönetilmesi için kullanılır.
Özet
MasalSes API'si, masal ve hikaye metinlerini profesyonel ses dosyalarına dönüştürmek için tasarlanmış, yayıncılar için özel olarak geliştirilmiş bir çözümdür. Basit JSON tabanlı yapısı ve OpenAI SDK uyumluluğu sayesinde entegrasyon süreciniz hızlı ve hatasız ilerler.
Üretim süreçlerinizi otomatikleştiren bu sistem, düşük maliyet ve yüksek ölçeklenebilirlik sunar. Her bir adım, metinlerin net ve güvenilir şekilde sese dönüştürülmesi odaklı çalışır.
Hızlı entegrasyon
API, mevcut OpenAI SDK'larınıza sadece base_url değiştirerek entegre edilebilir. Bu sayede ek kod yazmadan mevcut sistemlerinize ses dosyası üretim yeteneği kazandırabilirsiniz.
- JSON tabanlı POST isteği
- OpenAI SDK uyumluluğu
- Hazır curl örnekleri
Düşük maliyet
Her 1 milyon karakter için sadece 10 $ ödeme yaparak maliyetlerinizi kontrol altında tutun. Başarısız isteklerde ücret alınmaz ve kalan bakiye süresiz olarak saklanır.
- 1000 karakter başına 0.01$
- TRC-20 USDT ile anında yükleme
- Başarısız istekler ücretsiz
Yüksek ölçeklenebilirlik
4096 karakterlik metinler otomatik olarak bölünür ve birleştirilir. Uzun hikayeleriniz veya e-kitaplarınız için tek bir istekle tüm içeriği seslendirebilirsiniz.
- Metin bölme ve birleştirme
- 60 istek/dakika limiti
- 23 dil desteği
8 sesi dinleyin
Aşağıdaki her örnek, aynı cümle bu API tarafından üretilmiştir. Bu durum, hata ayıklama sürecini basitleştirir ve geliştirme hızını artırır.
23 dil
Her ses bu dillerden birini konuşabilir.
Kaynaklar ve ileri okuma
- Wikipedia
- Tether (USDT)
- Node.js documentation
- Creative Commons Attribution 4.0
- openai-node on GitHub
- ISO 639 language codes
- TRON developer hub: TRC-20
- OpenAI API reference: create speech
- IETF RFC 7845: Ogg Opus
- LibriTTS-R corpus (OpenSLR 141)
- W3C WAI: making audio and video accessible
- LibriTTS-R paper (arXiv 2305.18802)
