Voiser Metinden Sese API'si ile Metinleri sese dönüştürün

Yazan Voiser API editör ekibi · Güncellendi 2026-11-19

Voiser TTS API'si, indie geliştiriciler için tasarlanmış, OpenAI SDK uyumlu deterministik bir metinden sese çözümüdür. JSON tabanlı yapısı sayesinde mevcut geliştirme iş akışlarınıza kolayca entegre edilebilir. Bu sayfada API'nin teknik altyapısını, desteklenen sesleri ve entegrasyon adımlarını detaylı olarak bulabilirsiniz.

Otomatik bildirimler, kullanıcı arayüzleri ve kısa metin işlemleri için yüksek kaliteli ses üretimi sunarız. 23 dil desteği, 8 farklı ses tonu ve esnek hız ayarı ile ihtiyaçlarınıza uygun sonuçlar elde edin. Teknik detaylar, performans metrikleri ve fiyatlandırma modeli hakkında bilgi almak için aşağıdaki bölümleri inceleyin.

Voiser Metinden Sese API'si ile Metinleri sese dönüştürün

Sıkça sorulan sorular

Voiser seslendirme API'si nedir?

Voiser, metni sese dönüştüren bulut tabanlı bir TTS API'sidir. Metin gönderdiğinizde bir ses dosyası alırsınız. İstekler, OpenAI Speech uç noktasıyla aynı şekildedir. Bu sayede OpenAI SDK'larını temel URL'yi değiştirerek doğrudan kullanabilirsiniz. İstemci tarafı veya özel bir SDK gerektirmez. Sadece HTTP POST istekleri ile entegrasyon sağlanır.

API'yi nasıl entegre edebilirim?

POST https://api.b444.info/v1/audio/speech uç noktasını kullanın. JSON gövdesinde model, input, voice ve response_format alanlarını belirtin. Yetkilendirme için Authorization: Bearer tts-... başlığını ekleyin. OpenAI SDK'larını base_url'i https://api.b444.info/v1 olarak ayarlayarak doğrudan kullanabilirsiniz. Bu yapı, mevcut OpenAI istemci kütüphaneleriyle tam uyumludur.

Hangi sesler mevcut?

Sekiz hazır ses seçeneği sunulur: Aria, Nova, Luna, Sage, Felix, Milo, Atlas ve Orion. Bu sesler LibriTTS-R veri setinden ve LibriVox kamu malı ses kayıtlarından türetilmiştir. Her ses, farklı ton ve kullanım senaryolarına uygun olarak tasarlanmıştır. Sesler, metnin diline ve yapısına göre otomatik olarak seçilebilir veya manuel olarak atanabilir.

Hangi diller destekleniyor?

İngilizce, Almanca, Fransızca, İspanyolca, Japonca, Korece, Çince, Arapça, Hintçe, Rusça, Türkçe ve diğerleri dahil olmak üzere 23 dil desteklenir. Dil belirtilmezse metnin script'ine göre varsayılan olarak İngilizce kabul edilir. Desteklenmeyen diller arasında Vietnamca, Endonezce, Tayca ve Ukraynaca yer alır. Doğru dil kodunu belirtmeniz önerilir.

Hangi ses formatlarını destekliyorsunuz?

API, MP3, WAV, Opus, FLAC ve PCM ses formatlarını destekler. İsteğinizde response_format alanını belirterek istediğiniz formatı seçebilirsiniz. Bu formatlar, farklı kullanım senaryoları için esneklik sağlar. Ses dosyaları, standart HTTP yanıtları aracılığıyla iletilir. Özel bir codec veya sıkıştırma seçeneği ek olarak sunulmaz.

Hız ayarı nasıl yapılır?

Hız ayarı, isteğin gövdesindeki 'speed' alanı aracılığıyla yapılır. Bu alan 0.25 ile 4.0 arasında bir değer alabilir. Varsayılan hız genellikle 1.0'dır. Hız ayarı, sesli metnin okuma hızını etkiler. Bu ayar, metnin uzunluğuna veya diline bağlı olarak otomatik olarak değiştirilmez. Manuel olarak belirlenmelidir.

Karakter limiti nedir?

Her istek için maksimum 4096 karakterlik bir metin sınırı vardır. Bu sınır, boşluklar ve noktalama işaretleri dahil olmak üzere tüm karakterleri kapsar. Daha uzun metinler için istemci tarafında bölme ve birleştirme işlemleri yapılmalıdır. Bu yaklaşım, API'nin basit ve tahmin edilebilir bir çalışma yapısına sahip olmasını sağlar.

Fiyatlandırma nasıl çalışır?

Fiyatlandırma, 1 milyon karakter başına 10 ABD Doları olarak belirlenmiştir. Bu, 1000 karakter başına 0.01 ABD Doları anlamına gelir. Boşluklar ve noktalama işaretleri karakter sayısına dahildir. Her istek, kullanılan karakter sayısına göre faturalandırılır. Toplu istekler için indirim yoktur. Fiyatlar sabittir ve zamanla değişmez.

Başarısız isteklerde ücret alınır mı?

Sentez işlemi başarısız olursa, tam ücret iade edilir. Başarısız istekler ücretsizdir. Bu kural, API'nin güvenilirliğini artırır. İstekler, sunucu tarafında işlenirken bir hata oluşursa, kullanıcıdan ücret alınmaz. Bu kural, tüm istek türleri için geçerlidir. Başarılı istekler ise tam ücretle faturalandırılır.

Hangi ödeme yöntemlerini kabul ediyorsunuz?

Yalnızca TRON ağı (TRC-20) üzerinden USDT kabul edilir. Minimum yükleme tutarı 5 ABD Dolarıdır. Ödemeler, transferin onaylanmasından sonra birkaç dakika içinde hesabınıza işlenir. Kredi kartı, PayPal veya fatura seçeneği yoktur. Abonelik planları da bulunmamaktadır. Bakiye süresi dolmaz ve her zaman kullanılabilir.

Hızlı teslimat garantisi var mı?

Kesin bir teslimat süresi garantisi (SLA) sunulmaz. Uzun metinler için ortalama hız, saniyede yaklaşık 25 karakterdir. Kısa metinler birkaç saniye sürebilir. Yoğunluk altında istekler bir kuyrukta bekleyebilir. Bu durum, sunucu kaynaklarının paylaşımı nedeniyle ortaya çıkar. Gerçek zamanlı akış (streaming) desteği yoktur.

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

Girdi metniniz yalnızca ses dosyası oluşturmak için kullanılır ve eğitim için kaydedilmez. Oluşturulan ses dosyaları yanıtta iletilir ve depolanmaz. İstek meta verileri (zaman, karakter sayısı, durum) faturalandırma için saklanır. Bu veri, kullanıcı kimliğiyle ilişkilendirilerek hesaplamalar için kullanılır. Veriler üçüncü taraflarla paylaşılmaz.

API anahtarımı nasıl yenileyebilirim?

Hesap ayarlarından yeni bir API anahtarı oluşturabilirsiniz. Yeni anahtar oluşturulduğunda, eski anahtar anında geçersiz kılınır. Bu işlem, mevcut istekleri etkilemez ancak yeni istekler için geçerlidir. Anahtarlar, güvenlik amacıyla düzenli olarak yenilenebilir. Her hesap için yalnızca bir aktif anahtar bulunur. Anahtarlar, site üzerinden yönetilir.

Destek hangi kanaldan sağlanır?

Destek yalnızca e-posta yoluyla sağlanır. Telefon numarası veya canlı destek bulunmaz. E-posta desteği, teknik sorunlar ve faturalandırma ile ilgili sorular için mevcuttur. Yanıt süreleri, talep yoğunluğuna göre değişebilir. Canlı destek veya SLA garantisi yoktur. Sorularınızın detaylı bir şekilde incelenmesi için e-posta tercih edilir.

İlk istek

curl

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

API Entegrasyonu

İçin ses dalga görseli: API Entegrasyonu

Voiser API, metni JSON formatında alıp ses dosyası olarak döndüren bulut tabanlı bir hizmettir. RESTful mimariye sahip yapısı, geliştiricilerin mevcut altyapılarına sorunsuz entegrasyon yapmasını sağlar.

API, standart HTTP istekleri üzerinden çalışır. Bu sayede herhangi bir özel istemciye ihtiyaç duymadan doğrudan entegrasyon mümkündür.

JSON tabanlı yapı

JSON tabanlı yapı

İstek gövdesi, model, input, voice ve response_format alanlarını içeren standart bir JSON nesnesidir. Veri yapısı basit ve belirlenmiştir; bu da hata ayıklama sürecini hızlandırır.

Her istek, belirtilen karakter sınırına (4096 karakter) göre işlenir. Yanıt, doğrudan dinlenebilir bir ses dosyası veya hata detayları içeren JSON olarak döner.

  • Standart JSON request/response yapısı
  • 4096 karakterlik input limiti
  • Hata durumunda detaylı JSON yanıtı

OpenAI SDK uyumluluğu

API endpoint yapısı, OpenAI Speech endpoint'i ile aynı şekildedir. Bu uyumluluk, mevcut OpenSDK'ların base_url parametresi değiştirilerek doğrudan kullanılmasını sağlar.

Bu yaklaşım, ekstra kütüphane yükü olmadan güçlü dil desteği ve hata yönetimi mekanizmalarından yararlanmanızı sağlar.

Geliştiriciler, tanıdık veri modellerini kullanarak entegrasyon süresini minimize edebilir.

  • OpenAI SDK ile doğrudan uyumlu
  • Sadece base_url değiştirilmesi yeterli
  • Ekstra kütüphane gerektirmez

Basit POST isteği

Sentez işlemi için POST https://api.b444.info/v1/audio/speech endpoint'ine bir istek gönderilir. Kimlik doğrulama, Authorization: Bearer başlığı ile sağlanır.

İstek başarılı olduğunda, HTTP yanıt gövdesinde ses dosyası bulunur. Başarısız durumlarda (örneğin geçersiz ses kipi), uygun hata kodu döndürülür ve ücret alınmaz.

İstek yapısı, tts-1 veya tts-1-hd model seçimi ile başlar. Gerekli parametreler eksiksiz sağlandığında işlem otomatik olarak başlatılır.

  • Endpoint: POST /v1/audio/speech
  • Bearer token kimlik doğrulama
  • Başarısız isteklerde ücret alınmaz

Desteklenen Sesler

İçin ses dalga görseli: Desteklenen Sesler

Voiser API, metinleri yüksek kaliteli sese dönüştürmek için sekiz önceden ayarlanmış ses modu sunar. Her ses, lisanslı kayıtlara dayanır ve deterministik üretim için optimize edilmiştir. Gerekli ses tonunu seçerek endüstriyel gereksinimlerinizi karşılayabilirsiniz.

Kadın sesler (Aria, Nova, Luna, Sage)

Aria, net ve sıcak bir anlatıcı tonu sunarak profesyonel içerikler için uygundur. Nova, parlak ve enerjik yapısıyla dikkat çeker. Luna, hikaye anlatımı odaklı yumuşak bir tona sahiptir. Sage ise yönlendirici ve sakin bir anlatım sağlar.

  • Aria: Sıcak, net anlatıcı
  • Nova: Parlak, enerjik
  • Luna: Yumuşak, hikaye anlatımı
  • Sage: Sakin, yönlendirici

Erkek sesler (Felix, Milo, Atlas, Orion)

Felix, yüksek enerjili yapısıyla promosyon içeriklerinde öne çıkar. Milo, samimi ve sohbet havasında bir dil kullanır. Atlas, nötr ve tarafsız bir ses tonuyla haber bültenleri için idealdir. Orion ise derin ve ciddi bir ton sunar.

  • Felix: Enerjik, promosyon
  • Milo: Samimi, sohbet
  • Atlas: Nötr, haber
  • Orion: Derin, belgesel

Sesin ton ve kullanım alanları

Sesler, belirli kullanım alanlarına göre seçilebilir. Kullanıcı arayüzleri için nötr tonlar, bildirimler için net sesler tercih edilebilir. Her ses, 23 dilde akıcı bir şekilde konuşabilir. Sesler, otomatik bildirim sistemlerinde tutarlılık sağlar.

Dil ve Format Desteği

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

API'niz 23 farklı dilde metin sentezi yapabilir. Sesler, dil ayrımı gözetmeksizin tüm desteklenen dillerde tutarlı kalite sunar. Bu yapı, çok dilli uygulamalar için tek bir endpoint üzerinden hizmet vermenizi sağlar.

Gönderilen metinlerin işlenmesi sırasında dil belirleme otomatik olarak gerçekleştirilir. Latin alfabesi kullanan metinler varsayılan olarak İngilizce olarak işlenir. Varsayılan davranıştan sapan diller için language parametresi açıkça belirtilmelidir.

23 farklı dil desteği

Araba, Ç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 dilleri desteklenir.

Desteklenmeyen diller arasında Vietnamca, Endonezca, Tayca, Ukraynaca, Romence, Çekçe, Bengalce ve diğerleri yer alır. Bu dillerde sentez işlemi başarısız olur veya beklenmeyen sonuçlar üretir.

Ses formatları (MP3, WAV, OPUS, FLAC, PCM)

İstemciler, response_format parametresi aracılığıyla MP3, WAV, OPUS, FLAC veya PCM formatlarını seçebilir. Format tercihi, hedef platformun codec gereksinimlerine göre belirlenir.

Seçilen format, sunucudan dönen yanıt gövdesinde doğrudan iletilir. Format değişikliği ek karakter ücreti veya işlem süresi değişikliği yaratmaz.

Otomatik dil algılama

language parametresi belirtilmediğinde sistem, metnin scriptine dayanarak dili tahmin eder. Latin alfabesi içeren metinler varsayılan olarak İngilizce olarak işlenir.

Latin alfabesi kullanılmayan diller veya İngilizce olmayan Latin metinler için language parametresinin açıkça ayarlanması önerilir. Yanlış tahmin, sentez kalitesini düşürür.

Hız ve Performans

İçin ses dalga görseli: Hız ve Performans

Üretim hızı, uzun metinlerde yaklaşık gerçek zamanlıdır; saniyede yaklaşık 25 karakter işlenir. Kısa cümleler için birkaç saniye sürer. İstekler sırayla işlenir, bu nedenle yoğunluk altında bekleme süresi oluşabilir.

Gecikmeler, kuyruk yapısı nedeniyle değişebilir ancak işleme mantığı sabittir.

Gerçek zamanlı üretim hızı

Uzun metinlerde üretim hızı yaklaşık gerçek zamanlıdır. Saniyede yaklaşık 25 karakter işlenir. Kısa metinler için işlem süresi birkaç saniye sürer.

Kuyruk yapısı ve işleme

İstekler sırayla işlenir. Yoğunluk altında bir istek, kuyrukta bekleyebilir. Bu durum, yüksek trafikte gecikmelere neden olabilir.

Hız ayarı (0.25x - 4.0x)

Hız, 0.25 ile 4.0 arasında ayarlanabilir. Bu parametre, üretim süresini ve sesin akıcılığını doğrudan etkiler. Varsayılan hız 1.0'dır.

  • Minimum hız: 0.25x
  • Maksimum hız: 4.0x
  • Varsayılan: 1.0x

Ücretlendirme Modeli

İçin ses dalga görseli: Ücretlendirme Modeli

API kullanımı, karakter sayısına dayalı şeffaf bir ücretlendirme modeline göre çalışır. Her 1 milyon karakter için 10 ABD doları (0,01 $/1000 karakter) ücret alınır. Boşluklar ve noktalama işaretleri de karakter sayımına dahildir.

Sentez işlemi başarısız olursa, karakter ücreti kullanıcıya tam olarak iade edilir. Bu sayede, başarılı olmayan istekler için ekstra maliyet ödenmez.

Karakter başına ücretlendirme

Kullanım, harcanan karakter adedi üzerinden hesaplanır. Ücretlendirme modeli, büyük hacimli veri işlemlerinde bile maliyetlerin öngörülebilir olmasını sağlar. Toplu işlemlerde metinler 4096 karakterlik parçalara bölünerek işleme alınır.

Başarısız isteklerde iade

API çağrısı sırasında bir hata oluşması durumunda, ilgili karakter ücreti hesabınıza geri yüklenir. Bu durum, geçici sunucu yoğunluklarında veya geçici bağlantı sorunlarında bile adil bir ücretlendirme süreci sağlar.

Süreksiz ödeme (USDT)

Ödemeler, yalnızca TRON (TRC-20) ağı üzerinden USDT ile yapılır. Minimum yükleme tutarı 5 ABD dolarıdır. Transferler, ağ onay süresi genellikle birkaç dakika içinde tamamlanır ve bakiye otomatik olarak yüklenir. Aylık abonelik veya ek ücret yoktur.

Bakiye süresiz olarak saklanır ve kullanım süresiyle ilgili bir son tarih uygulamaz. Kredi kartı veya PayPal gibi üçüncü taraf ödeme yöntemleri bulunmaz.

Ücretlendirme Modeli

Kullanım Alanları

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

Voiser API, endüstriyel bildirim sistemleri ve kullanıcı arayüzleri için deterministik metin işleme sağlar. Sistemler, kullanıcı etkileşimlerini sesli geri bildirimlerle destekleyerek erişilebilirliği artırır.

API, kısa metinlerin hızlı dönüşümünü garant eder. Bu sayede otomatik bildirimler ve arayüz sesleri üretilir.

Otomatik bildirimler

API, kullanıcı bildirimlerini sesli formatlara dönüştürür. Bu özellik, otomatik bildirim sistemlerinin veri akışını zenginleştirir ve kullanıcı etkileşimini artırır.

Her bildirim, tek bir POST isteği ile işlenir. Başarısız isteklerde ücret iade edilir, bu da sistem güvenilirliğini artırır.

  • Otomatik bildirim entegrasyonu
  • Sesli geri bildirim desteği

Arayüz sesleri

Kullanıcı arayüzleri, Voiser API ile sesli öğeler içerir. Bu sesler, kullanıcı deneyimini iyileştirir ve erişilebilirlik standartlarını karşılar.

Her ses, istek üzerine üretilir. Bu sayede arayüzler, kullanıcı etkileşimlerine anında tepki verir.

  • Arayüz sesleri entegrasyonu
  • Erişilebilirlik desteği

Kısa metin işlemleri

API, kısa metinlerin hızlı dönüşümünü sağlar. Bu özellik, sık kullanılan bildirimler ve arayüz sesleri için idealdir.

Her metin, 4096 karakter sınırı içinde işlenir. Bu sayede sistemler, yüksek hacimli veri akışlarını destekler.

  • Kısa metin işleme
  • Hızlı dönüşüm

Teknik Özellikler

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

Uzun metinlerin işlenmesi için her API isteği 4096 karakterlik bir sınıra sahiptir. Bu sınırın aşılması durumunda, metin otomatik olarak parçalara bölünür ve her parça ayrı bir audio dosyası olarak üretilir. Sonuçta, bu ses dosyaları birleştirilerek kesintisiz bir çıktı elde edilir.

Güvenlik ve izlenebilirlik açısından, her üretilen ses dosyasının içinde, sesin yapay zeka tarafından oluşturulduğunu gösteren görünmez bir veri işareti (watermark) bulunur. Bu işaret, sesin kökenini doğrulamak için kullanılabilir.

Karakter sınırı (4096)

Tek bir POST isteğinde gönderilebilecek metin uzunluğu 4096 karakterle sınırlıdır. Bu sınırın üzerinde metinler için, uygulama katmanında metnin parçalara bölünmesi ve her parça için ayrı bir API çağrısı yapılması gerekir.

Başlık doğrulama

İsteklerde, Authorization başlığına "Bearer <API_KEY>" formatında değer eklenmelidir. Geçersiz veya süresi dolmuş bir anahtar durumunda, sunucu 401 Unauthorized hatası döndürür.

Sanal veri işaretleme

Oluşturulan her ses dosyası, içinde gizli bir watermark barındırır. Bu işaret, sesin sentetik olup olmadığını tespit etmek için kullanılan bir tekniktir.

Entegrasyon Kolaylığı

İçin ses dalga görseli: Entegrasyon Kolaylığı

API anahtarınızı doğrudan kontrol panelinizden yönetin. Tek bir aktif anahtar ile işlemlerinizi başlatın, ihtiyaç duyduğunuzda yeni anahtar oluşturarak eskiyi anında iptal edebilirsiniz.

OpenAI SDK veya doğrudan HTTP istekleri ile entegrasyon sağlar. Base URL'i yapılandırarak mevcut altyapınıza entegre olmanız yeterlidir.

API anahtarı yönetimi

Kontrol panelinde mevcut anahtarınızı görüntüleyin. Yeni anahtar oluşturduğunuzda, eski anahtar anında geçersiz olur. Bu sayede güvenlik açıklarını anında kapatabilirsiniz.

  • Tek aktif anahtar kuralı
  • Anında iptal özelliği
  • Kontrol paneli üzerinden yönetim

Kurulum adımları

Base URL'i https://api.b444.info/v1 olarak ayarlayın. tts-1 veya tts-1-hd modelini seçerek POST isteğini gönderin. SDK yapılandırması standarttır.

Kısa süre içinde ses dosyasını alın. Hız ayarını 0.25 ile 4.0 arasında yapılandırarak üretim sürecini optimize edin.

  • Base URL yapılandırması
  • Model seçimi
  • Hız parametresi ayarı

Hata yönetimi

Başarısız isteklerde ücret iade edilir. Bu sayede hata durumunda maliyet artışı yaşanmaz.

Rate limit aşımında istekler reddedilir. 60 istek/dakika limitini takip edin.

  • Ücret iadesi garantisi
  • Rate limit yönetimi
  • Standart HTTP hata kodları

Veri Güvenliği

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

Girdi veriniz yalnızca ses üretim aşamasında kullanılır ve eğitim verisi olarak işlenmez. Üretilen ses dosyası yanıt üzerinden iletilir ve kalıcı olarak saklanmaz.

Bilgi işlem amaçlı meta veriler (zaman, karakter sayısı, durum) faturalandırma için kaydedilir. Bu veriler yalnızca işlemin doğruluğunu teyit etmek için kullanılır.

Girdi verisinin işlenmesi

Metin, ses dosyası oluşturulma sürecinde geçici olarak işlenir. İşlem tamamlandığında, ham metin verisi kalıcı depolama alanına kaydedilmez ve eğitim amaçlı kullanılmaz.

Üretilen sesin depolanmaması

Ses dosyası, API isteğinin yanıtı olarak tarafınıza iletilir. Servis tarafında dosya kalıcı olarak arşivlenmez; yalnızca istemci tarafında saklanır.

Meta verilerin saklanması

İstek zamanı, karakter sayısı ve işlem durumu gibi meta veriler faturalandırma doğruluğu için tutulur. Bu veriler, işlem geçmişinin izlenebilmesi amacıyla saklanır.

8 sesi dinleyin

Aşağıdaki her örnek, aynı cümle bu API tarafından üretilmiştir. Kısa uyarı mesajları veya bildirimler için bu süre birkaç saniye olarak gerçekleşir.

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. Node.js documentation
  3. Creative Commons Attribution 4.0
  4. Tether (USDT)
  5. W3C WAI: making audio and video accessible
  6. MDN: Web Speech API
  7. openai-node on GitHub
  8. ISO 639 language codes
  9. openai-python on GitHub
  10. TRON developer hub: TRC-20
  11. OpenAI API reference: create speech
  12. FFmpeg documentation

Sitede daha fazla