Voiser API: Metin Seslendirme Entegrasyonu ve Kullanım Rehberi

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

Bu rehber, Voiser API’yi uygulamanıza entegre etmek isteyen geliştiriciler için teknik bir yol haritası sunar. Metin seslendirmenin API tabanlı altyapıda nasıl yönetileceğini, ses ve dil seçeneklerini, karakter limitlerini ve maliyet yapısını adım adım açıklar. Doğrudan JSON istekleri ve SDK entegrasyonları üzerinden deterministik üretim süreçlerini keşfedin.

Sayfada; API endpoint yapıları, hız ayarları, ses formatları ve hata yönetimi gibi entegrasyon kritik detayları bulabilirsiniz. Aynı zamanda karakter bölme stratejileri, veri gizliliği politikaları ve sık sorulan teknik soruların net yanıtları yer alır. Bağımsız geliştiriciler için optimize edilmiş bu kaynak, API anahtarınızdan ilk ses dosyasına kadar olan tüm teknik adımları kapsar.

Voiser API: Metin Seslendirme Entegrasyonu ve Kullanım Rehberi

Sıkça sorulan sorular

API tabanlı mı web arayüzü mü?

Voiser API, POST isteği göndererek JSON formatında metin alıp ses dosyası döndüren bulut tabanlı bir API'dir. Web arayüzü yerine doğrudan HTTP istekleri veya OpenAI SDK'ları ile entegrasyon sağlar. Bu yapı, uygulamalarınıza deterministik metin seslendirme işlemleri eklemenizi sağlar.

Hangi sesler mevcut?

Sekiz hazır ses preseti mevcuttur: Aria, Nova, Luna, Sage, Felix, Milo, Atlas ve Orion. Sesler, LibriTTS-R (CC BY 4.0) veri setinden temin edilmiştir. Her ses, belirtilen tüm dillerde sorunsuz çalışır ve sentezlenen her dosya, yapay ses olduğunu belirten görünmez bir su işareti içerir.

Hangi diller destekleniyor?

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, Swahilice, İsveççe ve Türkçe dillerini destekler. Toplam 23 dildir. Vietnamca, Endonezce, Tayca, Ukraynaca, Romence ve Çekce gibi diller desteklenmez.

Hangi formatlar en iyi?

Çıktı formatı olarak mp3, wav, opus, flac ve pcm seçenekleri sunulur. İsteğe bağlı olarak response_format alanı kullanılarak istenen format belirlenebilir. Ses kalitesi veya dosya boyutu açısından bir format diğerinden üstün olarak tanımlanmaz; teknik gereksinimlerinize göre en uygun formatı seçebilirsiniz.

Hız nasıl ayarlanır?

Seslendirme hızı, istek gövdesindeki speed alanı ile 0.25 ile 4.0 arasında ayarlanabilir. Bu değer, sesin normalden daha yavaş veya hızlı okunmasını sağlar. Varsayılan hız değeri 1.0'dır. Hız değişikliği, sesin tonunu veya karakterini değiştirmez, sadece okuma temposunu etkiler.

Uzun metinler nasıl işlenir?

Her istek maksimum 4096 karakter içerebilir. Daha uzun metinler için, metni bu sınırı aşmayacak şekilde parçalara bölüp ayrı ayrı istekler göndermeniz gerekir. Sonuç olarak elde edilen ses dosyalarını kendi uygulamanızda birleştirerek tek bir akış oluşturabilirsiniz. Bu işlem, istemci tarafında yapılmalıdır.

Hız limiti nedir?

Her API anahtarı için dakika başına 60 istek sınırı uygulanır. Hesabınız ilk kez oluşturulduğunda ve henüz ödeme yapılmadığında bu limit dakika başına 10 istek olarak düşer. Limit aşımı durumunda istekler işlenmez veya gecikebilir. Ödeme yapıldıktan sonra limit otomatik olarak 60'a yükselir.

İlk yükleme öncesi limit nedir?

Yeni hesaplar, ilk yüklemeyi yapmadan önce dakika başına 10 istek ile sınırlıdır. Bu kısıtlama, hesabınızın doğrulanmasını ve bakiye yüklemesini takiben kaldırılır. Hesap oluşturulurken Google veya e-posta ile kayıt yapılmış olması, bu başlangıç limitini etkilemez. Limit, API anahtarınızın kullanım durumuna göre geçerlidir.

Yanıt nasıl işlenir?

API, POST isteğine yanıt olarak ses dosyasını doğrudan HTTP yanıt gövdesinde döndürür. Yanıt, belirtilen response_format (mp3, wav vb.) ile formatlanır. İstemciniz, yanıt başlıklarını ve gövdesini okuyarak ses dosyasını kaydedebilir veya işleyebilir. Yanıt, genellikle gerçek zamanlıdır ancak yük altında kuyrukta bekleme süresi olabilir.

Hata kodları nelerdir?

Standart HTTP hata kodları (4xx, 5xx) kullanılır. Örneğin, 401 yetkisiz erişim, 429 hız limiti aşımı anlamına gelir. API, hata durumunda detaylı bir JSON yanıt döndürerek sorunun nedenini belirtir. SSML desteği bulunmamaktadır. HTTP kodları standarttır.

Başarısız istekler nasıl işlenir?

Sentez işlemi başarısız olursa, harcanan karakter ücreti tamamen iade edilir. Bu, istek gövdesindeki verilerin işlenemediği veya sunucu hatası aldığı durumlar için geçerlidir. Başarısız istekler, bakiyenizden düşülmez. İsteğinizin başarılı olup olmadığını HTTP durum kodundan ve yanıt gövdesinden kontrol edebilirsiniz.

Meta veriler nerede saklanır?

İstek zamanı, karakter sayısı ve durum gibi meta veriler faturalandırma amacıyla saklanır. Girdi metni yalnızca ses üretimi için kullanılır ve eğitim verisi olarak işlenmez. Oluşturulan ses dosyaları sunucularda kalıcı olarak depolanmaz. Veriler, yalnızca hesap geçmişinizi görüntülemeniz için tutulur.

API Tabanlı vs. Web Arayüzü

İçin ses dalga görseli: API Tabanlı vs. Web Arayüzü

Voiser API, metinleri doğrudan ses dosyalarına dönüştüren bir bulut servisi olup, manuel arayüzler yerine programatik erişim sağlar. Bu yapı, yüksek hacimli bildirimler ve otomatik arayüzler için deterministik iş akışları oluşturmayı mümkün kılar.

API temelli kullanım, standart HTTP istekleri aracılığıyla entegrasyonu basitleştirir. Geliştiriciler, OpenAI SDK yapısını benimseyerek mevcut altyapılarına hızlıca uyum sağlayabilir.

Otomasyon avantajları

RESTful endpoint yapısı, mevcut uygulama veri akışlarına doğrudan entegrasyon imkanı tanır. Manuel dosya indirme veya kopyalama işlemleri kaldırıldığı için işlem hatası riski azalır.

Belirli tetikleyicilerle otomatik ses üretimi, kullanıcı arayüzleri ve sistem bildirimleri için tutarlı bir çıktı sağlar. Bu sayede zamanlanmış işler ve veri akışları kesintisiz yürütülür.

  • Programatik erişim ile manuel müdahale gerektirmez.
  • Tutarlı veri akışı ve standart çıktı formatı.
  • Altyapı bağımsız, genişletilebilir mimari.

API hızı

İstekler sırasıyla işlenir ve genellikle gerçek zamanlı üretim hızında (saniyede yaklaşık 25 karakter) sonuç üretilir. Uzun metinler için bölme stratejileri, verimliliği artırır.

Yüksek talepler altında kuyruk sistemi devreye girer. Bu durum, sistem stabilitesini korurken işlem sırasını garantiler.

Entegrasyon kolaylığı

API, OpenAI speech endpoint’iyle aynı istek yapısını kullanır. Base URL değişikliği ile mevcut SDK’lar doğrudan kullanılabilir.

JSON formatındaki istekler, standart HTTP kütüphaneleriyle kolayca gönderilebilir. Bu uyumluluk, farklı programlama dillerinde geliştirme süresini kısaltır.

  • Aynı JSON yapısı ve istek şeması.
  • Resmi SDK’larla doğrudan uyumlu çalışma.
  • Standart HTTP kütüphaneleri desteği.

Ses Seçimi Kriterleri

İçin ses dalga görseli: Ses Seçimi Kriterleri

Voiser API, metnin tonuna ve kullanım amacına uygun bir ses seçimi sağlar. Sesler, metnin doğrudan okunması veya otomatik bildirimlerde kullanılması gibi belirli senaryolar için tasarlanmıştır.

Ton ve kullanım alanı

Sesler, narratif anlatım, hızlı duyurular veya sakin talimatlar için optimize edilmiştir. Örneğin, sage sesi eğitim materyalleri için uygunken, felix promosyon metinleri için daha uygundur.

Kadın ve erkek sesler

Platformda dört kadın (aria, nova, luna, sage) ve dört erkek (felix, milo, atlas, orion) ses seçeneği mevcuttur. Her ses, farklı bir ton ve hız profili sunar.

Bu çeşitlilik, farklı hedef kitlelere hitap eden otomasyon sistemlerinde tutarlılık sağlar.

Ses lisansları

Tüm sesler, CC BY 4.0 lisansı altında LibriTTS-R veri setinden ve Kamu Malı Ses Kitaplarından (LibriVox) temin edilmiştir.

Bu durum, seslerin CC BY 4.0 lisansı altında olduğunu belirtir.

Dil ve Bölge Desteği

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

Voiser API, 23 farklı dilde yüksek kaliteli metin seslendirmesi sağlar. Her ses, tüm desteklenen dillerde sorunsuz çalışacak şekilde tasarlanmıştır. Bu yapı, çok dilli uygulamalar için tek bir endpoint ile geniş kapsamlı çözümler sunar.

Dil seçimi, metnin scriptine göre otomatik yapılır ancak kesin sonuç için language parametresi kullanılır. Desteklenmeyen diller için hata döndürülür veya varsayılan işleme uygulanır.

23 dil listesi

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.

Her ses preseti (Aria, Nova, Luna, Sage, Felix, Milo, Atlas, Orion) tüm bu dillerde kullanılabilir. Dil bağımsızlığı, tek bir ses havuzu ile global ölçeklendirmeyi mümkün kılar.

  • 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

Latin script varsayılanı

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

Bununla birlikte, Latin alfabesi kullanılan ancak İngilizce olmayan metinlerde (örneğin Almanca veya İspanyolca) dilin açıkça belirtilmesi önerilir. Bu, yanlış tahmin riskini ortadan kaldırır ve tutarlı ses çıkışı garantiler.

Desteklenmeyen diller

API, aşağıdaki dilleri desteklemez: Vietnamca, Endonezce, Tayca, Ukraynaca, Romence, Çekçe, Bengalce ve listede yer almayan diğer tüm diller.

Desteklenmeyen bir dil için istek gönderildiğinde, API hata döndürmez ancak metin varsayılan dilde (genellikle İngilizce) işlenebilir. Kesin dil desteği için GET /v1/voices endpointini kontrol edebilirsiniz.

Ses Formatı Seçimi

İçin ses dalga görseli: Ses Formatı Seçimi

Voiser API, metin seslendirmesi için beş farklı ses formatı sunar: MP3, WAV, OPUS, FLAC ve PCM. İsteğe bağlı olarak bu formatlardan biri seçilebilir; belirtilmezse varsayılan olarak MP3 döndürülür.

Format seçimi, üretim süresinden bağımsız olarak istenen ses kalitesini ve dosya boyutunu doğrudan etkiler. Her format, farklı kullanım senaryolarına ve sistem uyumluluğu gereksinimlerine göre optimize edilmiştir.

MP3, WAV, OPUS, FLAC, PCM

MP3, geniş uyumluluk için sıkıştırılmış bir seçenektir. WAV ve FLAC, kayıpsız formatlardır. OPUS, düşük bant genişliğinde verimli iletim için uygundur. PCM ise ham, işlenmemiş veri akışı sağlar.

  • MP3: Sıkıştırılmış, geniş uyumlu
  • WAV: Kayıtsız, yüksek kalite
  • OPUS: Verimli, düşük bant genişliği
  • FLAC: Kayıpsız sıkıştırma
  • PCM: Ham veri akışı

Formatlara göre boyut

Ses dosyasının boyutu, seçilen formata göre değişir. Kayıpsız formatlar (WAV, FLAC) daha büyük dosya hacimleri oluştururken, MP3 ve OPUS daha az yer kaplar. Bu durum, depolama maliyetlerini ve ağ trafiğini etkiler.

  • Kayıtsız formatlar daha büyük dosya hacmi üretir.
  • Sıkıştırılmış formatlar daha az yer kaplar.
  • Depolama maliyetleri format seçimine bağlıdır.

Uyumluluk kontrolü

Seçilen format, hedef platformun desteklediği codec ile uyumlu olmalıdır. MP3, neredeyse tüm modern sistemlerde varsayılan olarak desteklenir. Diğer formatlar için özel codec kurulumu gerekebilir. İstemci tarafında format doğrulaması yapmak, hata riskini azaltır.

Performans ve Hız

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

Voiser API, uzun metinlerde yaklaşık saniyede 25 karakterlik bir üretim hızı sunar; bu, metnin gerçek zamanlı okuma hızına eşdeğerdir. Kısa cümlelerin işlenmesi birkaç saniye sürer.

İstekler sırayla işlendiğinden, yüksek trafikte bir bekleme kuyruğu oluşabilir. Bu durum, deterministik ve sıralı işleme gerektiren otomasyon senaryolarında planlama yapılmasını zorunlu kılar.

Gerçek zamanlı üretim hızı

API, uzun metinler için metnin gerçek zamanlı okuma hızına yakın bir üretim performansı gösterir. Yaklaşık olarak saniyede 25 karakterlik metin işlenir. Bu oran, ses dosyasının hazır olma süresinin metin uzunluğuyla doğru orantılı olduğunu gösterir. Kısa uyarı mesajları veya bildirimler için bu süre birkaç saniye olarak gerçekleşir.

Kuyruk yapısı

Tüm istekler tek bir iş parçacığında ardışık olarak işlenir. Bu yapı, sistem stabilitesini korur ancak yüksek istek hacimlerinde kuyruk oluşmasına neden olabilir. Kuyruk süresi, o anki sistem yüküne bağlı olarak değişir. Bağımsız uygulama geliştiricileri, uzun metinler için istek gönderme zamanlamasını buna göre planlamalıdır.

Hız ayarı

İstek gövdesindeki speed parametresi ile ses okuma hızı 0.25 ile 4.0 arasında değiştirilebilir. Varsayılan değer 1.0'dır. Bu ayar, özellikle otomatik bildirim sistemlerinde veya kullanıcı arayüzlerinde metin okuma süresini optimize etmek için kullanılır.

Maliyet Yönetimi

İçin ses dalga görseli: Maliyet Yönetimi

Voiser API, metin seslendirmede şeffaf ve doğrudan karakter bazlı fiyatlandırma modelini kullanır. Her 1.000 karakter için $0,01 tutarında ücretlendirme yapılır. Boşluklar ve noktalama işaretleri de karakter sayımına dahil edilir. Bu yapı, maliyet tahminlerini hassas bir şekilde planlamaya olanak tanır.

API çağrısı başarısız olduğunda, ilgili işlem ücretsizdir ve ücret iade edilir. Bu mekanizma, hatalı isteklerin bütçeyi olumsuz etkilemesini engeller. Kullanıcılar, yalnızca başarılı ve tamamlanan sentezlemeler için ödeme yaparlar.

Karakter başına ücret

Fiyatlandırma modeli basittir: 1 milyon karakter başına $10. Bu oran, $0,01 / 1.000 karakter anlamına gelir. Uzun metinlerin işlenmesinde de bu oran geçerlidir. Hesaplama, girdi metnindeki tüm karakterleri kapsar.

  • 1 milyon karakter = $10
  • 1.000 karakter = $0,01
  • Boşluklar ve işaretler dahildir

Başarısız istekler

Sentezleme sırasında teknik bir hata oluşursa, ilgili karakter sayısı ücretlendirilmez. İstek başarısız olduğunda, kredi tam olarak iade edilir. Bu durum, hatalı konfigürasyonlardan kaynaklanan maliyet kayıplarını minimize eder.

USDT yükleme

Yükleme işlemleri yalnızca TRON ağı üzerinden USDT (TRC-20) ile yapılır. Minimum yükleme tutarı $5'tir. Transferler, ağ onayı alındıktan sonra birkaç dakika içinde bakiyeye işlenir. Kredi süresi dolmaz.

Bakiye süresiz geçerlidir. Aylık abonelik veya minimum harcama taahhüdü yoktur. Bakiye, yalnızca yapılan başarılı API istekleri için kullanılır.

  • TRC-20 USDT kabul edilir
  • Minimum yükleme: $5
  • Otomatik işlem süresi: birkaç dakika
  • Bakiye süresiz geçerlidir

Karakter Sınırı ve Bölme

İçin ses dalga görseli: Karakter Sınırı ve Bölme

API, her bir istek için maksimum 4096 karakterlik bir sınır uygular. Bu limit, uzun metinlerin tek bir istimde işlenemeyeceği anlamına gelir; bu nedenle içeriklerin bölünmesi gerekir. Metinleriniz bu sınırı aşarsa, istek başarısız olur veya beklenmedik davranışlar sergileyebilir.

Bölme işlemi, metnin karakter sayısına göre mantıklı parçalara ayrılmasıyla yapılır. Her parça, bağımsız bir API çağrısıyla işlenir. Bu strateji, veri kaybını önler ve ses dosyalarının doğru sırayla birleştirilmesini sağlar.

4096 karakter limiti

Her API isteği, input alanında maksimum 4096 karakteri kabul eder. Bu limit, hem harfleri hem de boşlukları ve noktalama işaretlerini içerir. Metin bu sınırı aşarsa, istek başarısız olur.

Bölme stratejisi

Uzun metinleri, anlamlı bütünlükleri bozmayacak şekilde bölmek kritiktir. Paragraf sonları veya cümle virgülleri, bölme noktaları olarak kullanılmalıdır. Bu yaklaşım, ses sentezinde kesiklik hissi yaratmaz ve işleme verimliliğini artırır.

Ses birleştirme

Bölünen her metin parçası için ayrı bir ses dosyası üretilir. Bu dosyalar, orijinal metnin akışını sürdürmek üzere ardışık olarak birleştirilmelidir. İstemci tarafında bu birleştirme işlemi, tek bir uzun ses dosyası oluşturmak için gereklidir.

Karakter Sınırı ve Bölme

Hata Yönetimi

İçin ses dalga görseli: Hata Yönetimi

Hata yönetimi, API'nin güvenilirliğini artıran temel bir bileşendir. Başarısız istekler, genellikle sunucu yanıt veremediğinde veya geçici bir aksaklık oluştuğunda meydana gelir. Bu durumlarda, API isteği tekrar denemeyi gerektirebilir.

Kredi iadesi mekanizması, kullanıcı bakiyesini korur. Yanıt kodları, hatanın türünü ve çözüm yolunu belirlemek için kullanılır. Bu yapı, otomasyon süreçlerinde beklenmedik veri kaybını önler.

Başarısız istekler

Başarısız istekler, sunucu tarafında geçici bir aksaklık veya yapılandırma hatası durumunda oluşur. Bu tür hatalar, isteğin tamamlanamaması anlamına gelir. İstekleriniz başarısız olduğunda, sunucu ilgili hata kodunu döner ve işlemi iptal eder.

Kredi iadesi

Bir istek başarısız olduğunda, harcanan karakter kredisi iade edilir. Bu iade, bakiye güncellemelerinde otomatik olarak gerçekleşir. Kullanıcılar, hata durumunda ekstra ücret ödemeden işlemlerini tekrarlayabilirler.

Yanıt kodları

API, her istek için HTTP yanıt kodları döner. Başarılı istekler 200, hatalı istekler ise 4xx veya 5xx kodları ile bildirilir. Bu kodlar, hata kaynağını tespit etmek ve uygun tepki vermek için kritiktir.

Güvenlik ve Doğrulama

İçin ses dalga görseli: Güvenlik ve Doğrulama

API isteği başlığına Authorization: Bearer tts-... formatında eklenmelidir. Bu yapı, Voiser API'nin standart doğrulama mekanizmasıdır ve tüm istemciler için geçerlidir.

Anahtar, hesap panelinde tekil olarak yönetilir. Yeni bir anahtar oluşturulduğunda eski anahtar anında geçersiz olur; bu durum güvenlik açığını minimize eder.

Bearer token kullanımı

Her API çağrısı, HTTP başlık alanında Authorization: Bearer tts-... belirteci taşımak zorundadır. Belirteç, hesabınıza ait tekil anahtarı temsil eder ve istek yetkilendirmesini sağlar. Bu standart yapı, OpenAI SDK'ları dahil olmak üzere çoğu modern kütüphane ile uyumludur.

  • Başlık adı: Authorization
  • Değer formatı: Bearer tts-<anahtar>
  • Tüm endpoint'ler için zorunludur

Anahtar gizliliği

API anahtarı, kimlik doğrulamanızın tek parolasıdır. Anahtarın üçüncü şahıslarca görülmesi, isteklerin sizin adınıza yapılmasına neden olabilir. Anahtarınızı kaynak kodunuzda açıkça bırakmak yerine, ortam değişkenleri veya güvenli yapılandırma dosyaları ile yönetiniz.

Bir anahtar aktif olduğunda, yeni bir anahtar oluşturulması durumunda eski anahtar anında devre dışı kalır. Bu özellik, anahtarın sızdırılması durumunda erişimi anında kesmek için tasarlanmıştır.

  • Tek aktif anahtar kuralı
  • Yeni anahtar, eskisini anında iptal eder
  • Ortam değişkenleri ile yönetilebilir

İstek doğrulaması

İstekler, sağlanan anahtarın geçerliliğine göre doğrulanır. Geçersiz veya süresi dolmuş bir anahtar ile gönderilen istekler, yetkisiz erişim hatası döndürür. Doğrulama işlemi, sunucu tarafında anlık olarak gerçekleştirilir ve ek bir imza veya zaman damgası gerektirmez.

Veri Gizliliği

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

Veri gizliliği, TTS API kullanımında kritik bir bileşendir. Girdi veriniz yalnızca ses üretim döngüsü içinde işlenir ve kalıcı olarak depolanmaz.

Üretilen ses dosyası yanıt üzerinden iletilir; sunucularımızda kalıcı bir kopyası saklanmaz. Bu, hassas metinlerin uzun süre depolanmasını önler.

Girdi verisinin işlenmesi

Metinler, ses sentezi işlemi tamamlandığında bellek alanından kaldırılır. Verileriniz eğitim amaçlı kullanılmaz.

Üretilen sesin depolanmaması

Sentezlenen ses dosyası, HTTP yanıtı ile istemciye iletilir. Sunucu tarafında, dosya boyutu veya içeriği bağımsız olarak kalıcı bir arşivde tutulmaz.

Meta verilerin saklanması

Faturalandırma ve kullanım analizi için zaman damgası, karakter sayısı ve istek durumu gibi meta veriler saklanır. Bu veriler, yalnızca hesap özetleri ve limit takibi amacıyla tutulur.

Entegrasyon Stratejisi

İçin ses dalga görseli: Entegrasyon Stratejisi

Entegrasyon stratejinizi belirlerken API anahtarının güvenli yönetimi kritik öneme sahiptir. Her hesap için yalnızca bir aktif anahtar bulunur; yeni bir anahtar oluşturulduğunda önceki anahtar anında geçersiz kılır. Bu durum, anahtarınızın sızması veya kullanımının sonlandırılması durumunda anında müdahale imkanı sağlar. Anahtarınızı Authorization: Bearer tts-... formatında istek başlıklarında iletmek zorundasınız.

Doğrudan HTTP istekleri veya OpenAI SDK'larını base_url değişikliği ile kullanabilirsiniz. Bu yaklaşım, harici bir SDK bağımlılığı yaratmadan mevcut geliştirme ekosisteminize sorunsuz entegrasyon imkanı tanır. İstek yapısı OpenAI speech endpoint'iyle uyumludur, bu da mevcut araçlarla kolayca test ve uygulama yapılmasını sağlar.

API anahtarı yönetimi

API anahtarınızı güvenli bir şekilde saklayın ve üretim ortamlarında ortam değişkenleri üzerinden yönetin. Her hesap için tek bir aktif anahtar bulunur; yeni anahtar oluşturulduğunda önceki anahtar anında geçersiz kılır. Bu mekanizma, anahtarın sızması veya kullanımdan kaldırılması durumunda anında güvenlik sağlar. Anahtar, Authorization: Bearer tts-... formatında HTTP başlığı ile iletilir.

  • Anahtar gizliliği için ortam değişkenlerini kullanın.
  • Yeni anahtar, eskiyi anında geçersiz kılar.
  • Her hesap için tek aktif anahtar.

Kod örnekleri

OpenAI SDK'larını base_url parametresini https://api.b444.info/v1 olarak ayarlayarak kullanabilirsiniz. Bu yapı, mevcut OpenAI entegrasyonlarınızın minimum değişiklikle Voiser API'ye geçmesini sağlar. Ayrıca doğrudan HTTP POST istekleri ile JSON formatında veri gönderimi de mümkündür. İstek gövdesinde model, input, voice ve response_format alanları belirtilmelidir.

  • OpenAI SDK'sı ile base_url ayarı.
  • Doğrudan HTTP POST istekleri.
  • JSON formatında veri gönderimi.

Hata yönetimi

API hatalarında HTTP yanıt kodları kullanılır. Başarısız istekler durumunda ücret iadesi tam olarak sağlanır. Hata durumlarında yanıt gövdesinde hata kodu ve açıklaması bulunur. Bu bilgiler, hata ayıklama ve loglama süreçlerinde kullanılmalıdır. İsteklerin sıraya alınması nedeniyle zaman aşımı hataları oluşabilir, bu durumda istek tekrar gönderilmelidir.

Sıkça Sorulan Sorular

İçin ses dalga görseli: Sıkça Sorulan Sorular

Voiser API ile ilgili teknik ve entegrasyon süreçlerine dair en çok sorulan sorular burada yanıtlanmıştır. Bu bölüm, API kullanımı sırasında karşılaşılabilecek temel durumları ve yapılandırma detaylarını netleştirir.

Desteklenen diller, ses formatları ve hata yönetimi gibi konulardaki sınırlar ve işleyiş mekanizmaları bu rehberde açıklanmıştır.

API tabanlı mı web arayüzü mü?

Voiser API bir web arayüzü değil, doğrudan kod ile entegre edilebilen bir REST API'dir. Kullanıcı arayüzleri ve otomatik bildirimler için deterministik TTS işlemleri gerçekleştirmek üzere tasarlanmıştır.

Hangi sesler mevcut?

Toplam 8 ses preseti mevcuttur: Aria, Nova, Luna, Sage (kadın) ve Felix, Milo, Atlas, Orion (erkek). Bu sesler, lisanslı kayıtlara dayanır ve 23 dilin tamamında kullanılabilecek şekilde yapılandırılmıştır.

  • Aria (sıcak, net anlatıcı)
  • Nova (parlak, enerjik)
  • Luna (yumuşak, hikaye anlatımı)
  • Sage (sakin, öğretici)
  • Felix (enerjik, promosyon)
  • Milo (arkadaşça, sohbet)

Hangi diller destekleniyor?

API 23 dili 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, Svahilice, İsveççe ve Türkçe.

  • Vietnamca, Endonezce, Tayca, Ukraynaca, Romence, Çekçe, Bengalce desteklenmez.
  • Latin scriptli metinler için varsayılan dil İngilizce'dir.
  • Dil kodunu belirtmek için language alanını kullanın.

Hangi formatlar en iyi?

Mevcut formatlar MP3, WAV, OPUS, FLAC ve PCM'dir. Hangi formatın en iyi olduğu, hedef platformunuzun gereksinimlerine ve dosya boyutu hassasiyetinize bağlıdır. MP3 ve OPUS daha küçük dosya boyutu sunarken, WAV ve FLAC yüksek kaliteli lossless veri sağlar.

Hız nasıl ayarlanır?

Konuşma hızı, istek gövdesindeki speed alanı ile 0.25 ile 4.0 arasında ayarlanabilir. Varsayılan değer 1.0'dır. Değer 1.0'dan yüksekse ses hızlanır, düşükse yavaşlar.

Uzun metinler nasıl işlenir?

Her istek maksimum 4096 karakter destekler. Daha uzun metinler için metni bu sınırı aşmayacak şekilde parçalara bölün. Oluşturulan ses dosyalarını uygulama katmanında veya istemci tarafında birleştirin.

Hız limiti nedir?

Her API anahtarı için dakika başına 60 istek limitidir. İlk yükleme yapılmadan önce bu limit dakika başına 10 istek olarak düşer.

İlk yükleme öncesi limit nedir?

Yeni hesaplar ve aktif yüklemeniz henüz gerçekleşmemiş hesaplar için dakika başına 10 istek limiti uygulanır. USDT ile ilk yüklemeniz onaylandıktan sonra limit 60 isteğe yükselir.

Yanıt nasıl işlenir?

API, POST isteğine yanıt olarak doğrudan ses dosyasını döndürür. Yanıt kodu 200 OK ise dosyayı kaydedin. Başarısız durum kodlarında hata mesajı JSON gövdesinde yer alır.

Hata kodları nelerdir?

Standart HTTP durum kodları kullanılır. 4xx serisi istek hatalarını (örn. geçersiz anahtar), 5xx serisi sunucu hatalarını belirtir. Detaylı hata mesajları JSON yanıt gövdesinde bulunur.

Başarısız istekler nasıl işlenir?

Sentez işlemi başarısız olursa, harcanan kredi tam olarak iade edilir. Hesap bakiyeniz bu durumda düşmez. İşlem loglarında bu durum 'failed' olarak kaydedilir.

Meta veriler nerede saklanır?

İstek zamanı, karakter sayısı ve durum gibi meta veriler faturalandırma amacıyla saklanır. Girdi metni ses üretimi için kullanılır ancak kalıcı olarak depolanmaz. Üretilen ses dosyası yanıt üzerinden alınır ve sunucuda saklanmaz.

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. openai-python on GitHub
  3. IETF RFC 7845: Ogg Opus
  4. Node.js documentation
  5. LibriTTS-R corpus (OpenSLR 141)
  6. ISO 639 language codes
  7. Python documentation
  8. MDN: Web Speech API
  9. TRON developer hub: TRC-20
  10. openai-node on GitHub
  11. Tether (USDT)
  12. OpenAI API reference: create speech

Sitede daha fazla