Sıkça sorulan sorular
Metin seslendirme programı nedir?
AracAPI Edit, bulut tabanlı bir metin-konuşma API'sidir. HTTP POST ile JSON gövdesi göndererek metni ses dosyasına dönüştürürsünüz. OpenAI Speech endpoint yapısıyla uyumludur. Doğrudan API çağrısı ile metinleri işleyebilir, ses dosyalarını alabilir ve yazılımınıza entegre edebilirsiniz.
Navigasyon uygulamalarında API kullanmanın avantajları nelerdir?
Doğrudan API kullanımı, büyük platformlara bağımlılığı azaltır. İsteğe bağlı dil kodu belirleyerek Türkçe veya diğer dillerde hassas kontrol sağlarsınız. Küçük veri hacimleri için uygun maliyetli çözümler sunar. Bağımsız geliştiriciler için esnek entegrasyon imkanı tanır ve navigasyon akışınızı tamamen siz yönetirsiniz.
API'nin hızı ne kadardır?
Uzun metinlerde ses üretimi yaklaşık gerçek zamanlıdır; saniyede 25 karakter işlenir. Kısa cümleler birkaç saniye sürebilir. İstekler sırayla işlendiğinden, yoğun yük altında kuyrukta bekleme olabilir. Bu durum, navigasyon yönergelerinin zamanında iletilmesi için planlamanızı etkileyebilir. Performans, sunucu durumuna göre değişir.
Hangi ses formatları desteklenir?
API mp3, wav, opus, flac ve pcm formatlarını destekler. Navigasyon uygulamaları için genellikle mp3 veya opus tercih edilir. PCM formatı ham veri için uygundur. Format seçimi, bant genişliği ve işlemci yükünü etkiler. İstenilen formatı response_format parametresi ile belirleyerek çıktıyı özelleştirebilirsiniz.
Kaç dil desteklenmektedir?
23 dil desteklenir: Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, Çince, Japonca, Korece, Arapça, Hintçe ve daha fazlası. Her ses tüm dillerde çalışır. Dil belirtilmezse Latin alfabesi için varsayılan İngilizce kabul edilir. Desteklenmeyen diller arasında Vietnamca ve Tayca bulunur. Doğru dil kodunu belirtmeniz önemlidir.
Sesler nasıl lisanslanmıştır?
Sesler, CC BY 4.0 lisansı altında LibriTTS-R veri setinden ve kamu malı LibriVox ses kayıtlarından türetilmiştir. Bu, ticari kullanım için uygun bir lisans modelidir. Üretilen her dosya, sentetik konuşmayı belirten inaudible bir su işareti taşır. Telif hakları konusunda net bir çerçeve sunar.
Karakter sınırları nelerdir?
Her istek için maksimum 4096 karakterlik metin sınırı vardır. Daha uzun metinleri bölüp ayrı isteklerle göndermeniz gerekir. Boşluklar ve noktalama işaretleri karakter sayısına dahildir. Bu sınır, API'nin işleme kapasitesine dayanır. Uzun navigasyon yönergelerini parçalara ayırarak seslendirmeniz gerekir.
Başarısız istekler ücretlendirilir mi?
Hayır, başarısız istekler ücretsizdir. Sentez işlemi tamamlanmazsa ücret tam olarak iade edilir. Bu, hatalı yapılandırmalar veya geçici sunucu sorunlarında maliyetinizi korur. Sadece başarılı işlemler için ücretlendirme yapılır. Bu özellik, geliştirme sürecinde riski azaltır ve güvenilir bir faturalandırma modeli sağlar.
OpenAI SDK ile uyumlu mudur?
Evet, endpoint yapısı OpenAI Speech endpoint'ine benzer. base_url parametresini https://api.scp012.info/v1 olarak ayarlayarak resmi OpenAI SDK'larını kullanabilirsiniz. Aynı istek şekli geçerlidir. Bu uyumluluk, mevcut kod tabanınızı hızlıca adapte etmenizi sağlar. Ek kütüphane yükü olmadan entegrasyon imkanı sunar.
Hangi sesler mevcuttur?
8 hazır ses vardır: Aria, Nova, Luna, Sage (kadın); Felix, Milo, Atlas, Orion (erkek). Her ses farklı tonlarda konuşur. Atlas veya Milo sesleri kullanılabilir. Sesler, farklı kullanım senaryolarına göre seçilebilir. Dil ve hız ayarlarıyla birlikte özelleştirilebilirler.
Ücretsiz deneme süresi var mıdır?
Google ile giriş yapanlar için 0,50 $ deneme kredisi (7 gün) sunulur. E-posta ile kayıt olanlar için başlangıç kredisi yoktur. Bu kredi yaklaşık 50.000 karakterlik kullanım imkanı tanır. Süre sonunda kredi yenilenmez. API'yi test etmek için iyi bir başlangıç noktasıdır.
Veriler eğitim için kullanılır mı?
Girdi metinleriniz yalnızca ses üretimi için kullanılır ve eğitim verisi olarak kaydedilmez. Üretilen ses dosyaları yanıtta döndürülür ancak depolanmaz. İstek meta verileri faturalandırma için saklanır. Veri gizliliğiniz korunur ve verileriniz üçüncü taraflarla paylaşılmaz. Bu, özel navigasyon verileri için önemlidir.
SMS veya canlı destek var mıdır?
Hayır, telefon numarası veya canlı destek yoktur. Destek yalnızca e-posta ile sağlanır. Bu, bağımsız geliştiriciler için standart bir iletişim kanalıdır. Yanıt süreleri değişebilir. Acil durumlar için telefon desteği vaat edilmez. Teknik sorunlarınızı e-posta yoluyla iletmelisiniz.
Faturalandırma nasıl yapılır?
Faturalandırma USDT (TRC-20) ile yapılır. Minimum yükleme 5 $'dır. Ödemeler TRON ağı üzerinden yapılır ve dakikalar içinde işlenir. Kredi kartı veya PayPal yoktur. Bakiye süresiz geçerlidir. Her 1 milyon karakter için 10 $ ücret alınır. Otomatik faturalandırma sistemi mevcuttur.
İlk istek
curl
curl https://api.scp012.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.mp3Araba İçi Seslendirme İçin API Yaklaşımı
AracAPI Edit, navigasyon yazılımları için metinleri doğal sesli yönlendirmelere dönüştüren bulut tabanlı bir API sunar. POST https://api.scp012.info/v1/audio/speech endpointi üzerinden gönderilen JSON verisiyle, kullanıcılar kısa uyarılardan uzun rota açıklamalarına kadar tüm metinleri ses dosyasına dönüştürebilir. Bu yaklaşım, harita verilerinin dinamik yapısıyla tam uyum sağlar.
API, OpenAI SDK yapısına benzer bir istek formatı kullanır, bu da mevcut geliştirme ekiplerinin entegrasyon süresini kısaltır. Metinler karakter sınırına (4096 karakter) göre bölünür ve ses dosyaları birleştirilerek kesintisiz bir deneyim sunar. Böylece navigasyon uygulamaları, gerçek zamanlı veri akışını kesintiye uğratmadan sesli geri bildirim sağlayabilir.
Metinleri sesli yönlendirmelere dönüştürme
API, tts-1 veya tts-1-hd modelleri aracılığıyla metinleri yüksek kaliteli ses dosyalarına dönüştürür. Kullanıcılar aria, nova, luna veya atlas gibi ses profillerinden birini seçerek yönlendirme tonunu belirleyebilir. Desteklenen formatlar (mp3, wav, opus) farklı araç içi ses sistemleriyle uyumlu çalışır.
- JSON tabanlı basit istek yapısı
- 4096 karakterlik metin desteği
- 8 farklı ses profili seçeneği
Veri akışı ve ses üretimi
Uzun metinler otomatik olarak parçalara bölünür ve ses dosyaları arka planda birleştirilir. Bu süreç, navigasyonun akıcılığını bozmadan veri akışının sürekli olmasını sağlar. Gecikme süreleri, kısa yönlendirmeler için birkaç saniye, uzun rotalar için ise gerçek zamanlıya yakın bir hız sunar.
Mobil ve web tabanlı navigasyon desteği
API, hem mobil hem de web tabanlı navigasyon uygulamalarıyla uyumlu çalışır. HTTP tabanlı yapısı sayesinde farklı platformlara kolayca entegre edilebilir. Bu esneklik, geliştiricilerin tek bir API anahtarı ile tüm platformlarda tutarlı bir ses deneyimi sunmasını sağlar.
Desteklenen Diller ve Sesler
AracAPI Edit, navigasyon yazılımlarınızda en doğal kullanıcı deneyimini sunmak için özenle hazırlanmış ses profilleri ve çoklu dil desteği sunar. Teknik gereksinimleriniz doğrultusunda, metinlerinizi anında sesli yönlendirmelere dönüştürürken dil ve ton farklılıklarını eksiksiz karşılarız.
Yol tarifi verirken veya trafik bildirimleri paylaşırken, sesin tonu ve hızı kullanıcı algısını doğrudan etkiler. Bu yüzden sunduğumuz 8 farklı preset ses profili, navigasyon bağlamına en uygun ses kaydını seçmenizi sağlar.
Türkçe ve İngilizce ses kaliteleri
Tüm desteklenen dillerde aynı ses kalitesini sunuyoruz. language parametresi ile dili manuel olarak belirtirseniz veya sistem otomatik olarak algılarsa, metninizdeki dil yapısına uygun doğal bir sentez gerçekleşir.
Özellikle navigasyon yönergelerinde sık karşılaşılan noktalı cümleler ve kısaltmalar için sesler, doğal konuşma ritmine sahiptir. Bu sayede kullanıcılar, makine gibi tınılı bir ses yerine, akıcı ve anlaşılır bir anlatım dinler.
8 farklı preset ses profili
23 dil desteği ile geniş coğrafya
API, 23 farklı dili destekler. Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, İtalyanca, Rusça, Japonca, Korece, Çince ve daha birçok dilde yüksek kaliteli ses üretimi yapabilirsiniz.
Desteklenen diller listesi şu şekildedir: 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, Swahili, İsveççe ve Türkçe. Bu geniş kapsama, uluslararası seyahat uygulamaları için büyük avantaj sağlar.
- Viyetnamca, Endonezce, Tayca, Ukraynaca, Romence, Çekçe, Bengalce ve diğer diller şu an desteklenmemektedir.
- Her ses, tüm desteklenen dillerde konuşabilir; ses profili dil seçimi ile sınırlı değildir.
Teknik Altyapı ve Uyumluluk
AracAPI Edit, OpenAI SDK’sini doğrudan kullanmanızı sağlar. base_url parametresini https://api.scp012.info/v1 olarak yapılandırıp mevcut kütüphane yapınızı koruyarak entegrasyonu tamamlayabilirsiniz.
OpenAI SDK ile entegrasyon kolaylığı
SDK ile yapılan istekler, API'nin beklediği JSON formatıyla uyumludur. Mevcut geliştirme alışkanlıklarınızı korurken, harici bir adaptör yazmaya gerek kalmadan ses üretimine geçebilirsiniz.
JSON tabanlı istek yapısı
İstek gövdesi; model, input, voice ve response_format alanlarını içerir. Bu yapı, HTTP POST istekleriyle doğrudan eşleşir ve karmaşık veri dönüşümlerini minimize eder.
Farklı ses formatları (mp3, wav, opus)
response_format parametresi ile çıktıyı MP3, WAV, Opus, FLAC veya PCM olarak belirleyebilirsiniz. Navigasyon uygulamalarınızın ses oynatma altyapısına en uygun codec'i seçerek bant genişliğini optimize edin.
Geliştirici Deneyimi
Geliştirici deneyimi, API anahtarının basit yönetimiyle başlar. Her hesap için tek aktif anahtar yeterlidir; yeni bir anahtar oluşturduğunuzda eskisi anında geçersiz olur. Bu sayede güvenlik riski minimize edilir ve entegrasyon süreci sade kalır.
Performans açısından metin uzunluğuna göre değişen gecikmeler yaşanır. Kısa yönlendirmeler birkaç saniye sürse de, uzun metinlerde gerçek zamanlı ortalamaya yaklaşılan bir hız elde edilir. Talepler sıraya alındığında bekleme süresi artabilir.
API anahtarı yönetimi
Güvenlik ve erişim kontrolü tek bir anahtar üzerinden sağlanır. Anahtar, hesabınızda listelenir ve istediğiniz zaman yenilenebilir. Eski anahtar, yeni oluşturulanın aktif hale gelmesiyle birlikte derhal sona erer; bu da sızıntı durumunda anında müdahale imkanı sunar.
- Tek aktif anahtar yapısı
- Anında geçersiz kılma özelliği
Hız ve gecikme performansı
Ses üretimi, metnin karakter uzunluğuna ve sistem yüküne bağlıdır. Kısa cümleler için birkaç saniye beklemeniz gerekebilir. Uzun metinlerde ortalama gerçek zamanlı ses üretim hızına (saniyede yaklaşık 25 karakter) ulaşılmaya çalışılır. Yoğun dönemlerde talepler bir kuyrukta işlenir.
- Kısa metinler: Birkaç saniye
- Uzun metinler: Gerçek zamanlı yakını
- Kuyruk yönetimi: Yoğunluk bazlı
Hata yönetimi ve yeniden deneme mekanizması
Sentezleme işlemi başarısız olursa, ücret iade edilir ve hata kodu döndürülür. Bu mekanizma, geliştiricilerin isteklerini güvenli bir şekilde yeniden denemesini sağlar. Başarısız isteklerinizden herhangi bir ücret yansıtılmaz, bu da test aşamalarında maliyet endişesini ortadan kaldırır.
- Başarısız isteklerde tam iade
- Hata kodu ile geri bildirim
Ses Kalitesi ve Doğallık
Ses dosyaları, yapay zeka tarafından üretildiğini belirten inaudible bir su işareti içerir. Bu damga, dinleyicilere sesin doğal bir insan tarafından değil, algoritmik bir süreçle oluşturulduğunu fark ettirmeden bildirir.
Tüm sesler, CC BY 4.0 lisansı altında LibriTTS-R veri setinden ve kamu malı audiobook kayıtlarından beslenir. Bu kaynaklar, seslerin doğal ve yüksek kaliteli olmasını sağlar.
Sentetik ses damgası (watermark)
Her ses dosyası, dinlenirken farkedilmeyen bir su işareti taşır. Bu özellik, içeriğin telif hakları ve kaynak belirtme gerekliliklerine uygun olarak kullanılmasını kolaylaştırır.
Lisanslı kayıt kaynakları
Kullanılan sesler, açık kaynaklı LibriTTS-R veri setinden ve kamu malı audiobook kayıtlarından elde edilir. Bu kaynaklar, seslerin doğal ve yüksek kaliteli olmasını sağlar.
Doğal konuşma ritmi
Sesler, doğal konuşma ritmine ve vurgulara sahiptir. Bu, navigasyon yönergelerinin dinleyiciler tarafından daha kolay anlaşılmasını ve takip edilmesini sağlar.

Kullanım Senaryoları
Navigasyon yazılımlarında dinamik veri akışı, kullanıcı deneyimini doğrudan etkiler. AracAPI, anlık trafik yoğunluğu veya rota değişiklikleri gibi verileri anında sesli yönlendirmelere dönüştürerek sürücünün ekrana bakma süresini azaltır. 4096 karakterlik metin limiti, karmaşık yön tariflerini bölmeden iletmeyi sağlar.
Doğal konuşma ritmi ve düşük gecikme süresi, özellikle şehir içi karmaşık kavşaklarda kritik öneme sahiptir. API, veriyi metinden sese dönüştürerek sürüş esnasında kafa yormayan, akıcı bir geri bildirim döngüsü oluşturur.
Anlık trafik bildirimleri
Gerçek zamanlı trafik verileri, API üzerinden metin olarak iletilir. Sistem, bu verileri anında sesli uyarılara dönüştürür. Böylece sürücü, yoğunluk veya kaza bilgilerini görsel olarak taramak yerine işitsel olarak alır.
- Anlık yoğunluk uyarıları
- Kaza ve yol kapanışı bildirimleri
- Rota alternatifleri için sesli yönlendirme
Hava durumu ve haber bültenleri
Navigasyon uygulamaları, sürüş sırasında hava durumu tahminlerini veya kısa haber bültenlerini sesli olarak sunabilir. AracAPI'nin çoklu dil desteği, farklı coğrafyalardaki kullanıcılar için yerel dilde içerik üretir.
Sesler, doğal bir anlatım diliyle hazırlanır. Bu sayede sürücü, yolculuk sırasında güncel bilgilere hızlıca ulaşabilir.
- Yerel hava durumu uyarıları
- Kısa haber özetleri
- Dil bazlı içerik üretimi
Kullanıcı etkileşimli asistanlar
Asistanlar, kullanıcıların sesli komutlarına yanıt vererek navigasyon verilerini sesli olarak aktarabilir. Bu entegrasyon, sürüş sırasında el kullanımı gerektirmeyen bir deneyim sunar.
AracAPI'nin işleme özelliği, asistanın yanıt vermesini sağlar. Bu da kullanıcı ile sistem arasındaki etkileşimi doğallaştırır.
- Sesli komut yanıtı
- Düşük gecikmeli yanıt süresi
- Doğal konuşma akışı
Maliyet ve Şeffaflık
AracAPI Edit, navigasyon uygulamaları için karmaşık abonelik modelleri yerine basit bir karakter bazlı fiyatlandırma sunar. Her 1.000 karakter için 0,01 USD ödersiniz. Boşluklar ve noktalama işaretleri de karakter sayısına dahildir.
Karakter başına ücretlendirme
Fiyatlandırma 1 milyon karakter başına 10 USD olarak belirlenmiştir. Bu model, kısa yönlendirme cümlelerinden uzun trafik bültenlerine kadar her türlü metin hacmi için ölçeklenebilir bir maliyet sağlar.
- 1 milyon karakter: 10 USD
- 1.000 karakter: 0,01 USD
- Havai istekler ücretsizdir
Başarısız isteklerde iade politikası
API'ye gönderilen ve işlenemeyen istekler için bakiyenizden herhangi bir kesinti yapılmaz. Hata durumunda tam iade otomatik olarak gerçekleşir, bu da beklenmedik maliyetleri önler.
Şeffaf faturalandırma sistemi
Kullanım istatistikleri ve bakiye durumu doğrudan dashboard'dan izlenebilir. Faturalandırma USDT (TRC-20) ile yapılır; fatura, KDV veya abonelik taahhütleri gibi gizli maliyetler içermez.
Entegrasyon Adımları
API anahtarınızı oluşturmak için /get-api-key/ sayfasına gidin. Google veya e-posta ile kaydolun. Hesabınız oluşturulduğunda, aktif anahtarınız ve bakiyeniz otomatik olarak görüntülenir. Her hesap için yalnızca bir aktif anahtar vardır; yeni anahtar talep edildiğinde eskisi anında geçersiz olur.
API anahtarı oluşturma
Kullanım limitleriniz ve karakter sayımınız sayfada anlık olarak gösterilir. Güvenlik için anahtarınızı kod tabanınızda saklayın ve isteklerinize Authorization: Bearer başlığı ile ekleyin.
İlk ses dosyası üretme
API'nin temel endpoint'i POST https://api.scp012.info/v1/audio/speech adresidir. İstek gövdesinde model, metin, ses profili ve dil parametrelerini belirtin. Yanıt olarak size ses dosyasını doğrudan döndürür.
Kod örneği ile test etme
OpenAI SDK'sını kullanarak entegrasyon başlatın. base_url değerini API adresinize ayarlayın. Aşağıdaki örnek, 'nova' sesiyle kısa bir yönlendirme metnini MP3 formatında üretir.
- client = OpenAI(base_url="https://api.scp012.info/v1", api_key="tts-...") response = client.audio.speech.create( model="tts-1", voice="nova", input="Sola dönün, 200 metre sonra varış noktası." )
Neden API Tabanlı Çözüm?
Navigasyon yazılımlarında sesli yönlendirmelerin kesintisiz çalışması, altyapının yükü kaldırabilmesiyle doğrudan ilişkilidir. API tabanlı yapı, ani trafik yoğunluklarında bile ses üretim işlemlerinin kesintiye uğramadan devam etmesini sağlar.
Geliştiriciler, ses motorlarının altyapı yönetimiyle uğraşmak yerine, uygulamanın çekirdek mantığına odaklanabilir. Bu sayede navigasyon verilerinin işlenmesi ve seslerin zamanında üretilmesi arasında optimal bir denge kurulur.
Ölçeklenebilir altyapı
Navigasyon uygulamaları, anlık trafik yoğunluğuna göre değişen istek hacimleriyle karşılaşabilir. AracAPI'nin bulut altyapısı, aynı anda yüzlerce yönlendirme isteğini işleyebilir ve her birini sıraya alarak sonuçlandırır.
- Ani yük artışlarında ses üretimini duraksatmaz
- Sabit genişletilebilir kapasite ile tutarlı deneyim sunar
Sürekli güncellenen ses motorları
Ses kalitesi ve dil desteği, geliştiricinin manuel müdahalesi olmadan merkezi sunucularda güncellenir. Böylece navigasyon yazılımı, en son dil ve ses presetlerini anında kullanabilir.
- Yeni dil ve ses ekleme süreci otomatiktir
- Kullanıcı tarafında yeni bir uygulama güncellemesi gerektirmez
Düşük bakım yükü
Ses dosyalarının barındırılması veya sunucu konfigürasyonlarının yönetimi geliştiriciye düşmez. API, tüm teknik altyapıyı tek bir uç nokta üzerinden yönettiği için bakım maliyetleri minimize edilir.
- Sunucu yönetimi API sağlayıcısında merkezileşmiştir
- Geliştirici yalnızca API çağrılarını yönetir
8 sesi dinleyin
Aşağıdaki her örnek, aynı cümle bu API tarafından üretilmiştir. Sesli asistanlar, sürücülerle etkileşim kurarak bilgi sağlar.
23 dil
Her ses bu dillerden birini konuşabilir.
