Entegrasyon rehberleri · 2026-09-27
Gemini 2.5 Pro Preview TTS ile Türkçe ve İspanyolca seslendirme
İki dilde seslendirme için metin hazırlama, voice seçimi, telaffuz ve dinleme kontrolü kurun. Gemini 2.5 Pro TTS isteklerini yeni modellerin parametreleriyle karıştırmayın.
Model sürümünü ve görevi sabitleyin
Gemini 2.5 Pro Preview TTS, metinden ses üretmek için kullanılan modeldir. İki dilde seslendirme hazırlarken model adını tam kaydedin: LLMTR’de google/gemini-2.5-pro-preview-tts. Genel bir Gemini sohbet örneğiyle ses üretim örneğini karıştırmayın. Ses almak için metin yanıtı bekleyen sohbet akışını değil, belgelenmiş TTS yolunu kullanın.
Google’ın güncel genel ses rehberi farklı model nesillerini birlikte anlatıyor. Daha yeni bir modelin metadata alanlarını veya ses tasarımı özelliklerini 2.5 Pro’ya otomatik taşımayın. Bu yazı Türkçe ve İspanyolca kayıtları değerlendirmek için bir çalışma düzeni sunuyor; canlı ses üretilmiş veya iki dilde aynı kalite ölçülmüş gibi bir iddia taşımıyor. Kendi kısa denemenizi dinlemeden yayın kararı vermeyin.
Çeviriyi seslendirmeden önce tamamlayın
Türkçe metinle İspanyolca metnin aynı bilgiyi taşıdığını yazılı halde doğrulayın. Ses üretiminden aynı anda çeviri yapmasını ve kusursuz telaffuz vermesini beklemek, bir sorun çıktığında nedenini ayırmayı zorlaştırır. Önce tarih, sayı, kişi ve ürün adlarını kontrol edin. Sonra iki metni ayrı kayıtlar olarak üretin; böylece yanlış dildeki bölümü yeniden üretmek kolaylaşır.
İspanyolca metin için hedef kitleyi belirleyin. Bölgesel kelime seçimi veya hitap biçimi metin aşamasında çözülmeli. Türkçe metinde uzun ekli adların ve kısaltmaların nasıl okunacağını açıklaştırın. Görsel arayüz için yazılmış düğme adları sesli anlatımda anlaşılmayabilir; kullanıcıya gerçekten ne yapacağını söyleyen kısa cümleler kurun. İki dilin birebir aynı kelime sayısına sahip olması gerekmez.
Kısa bir istekle ses seçimini doğrulayın
LLMTR’nin TTS yolunda model, input ve voice alanlarını kullanın. Gemini TTS için voice zorunludur. İlk isteği tek bir kısa cümleyle sınırlayıp yanıtın ses olarak açılabildiğini kontrol edin. Aşağıdaki gövde Türkçe deneme girdisidir; ölçülmüş bir çıktı değildir. İspanyolca denemede input metnini değiştirip aynı başlangıç koşullarını koruyun.
Yanıtı sohbet JSON’u gibi okumayın; bu endpoint ses baytları döndürür. Dosyanın biçimini ve oynatıcıda doğru açıldığını kontrol edin. Yalnızca dosyanın oluşması işin bittiğini göstermez: yanlış, eksik veya sessiz bir kayıt da dosya olarak kaydedilebilir. İlk dinlemede başlangıç ve bitişin kesilmediğine, metnin tamamının okunduğuna bakın.
POST /v1/audio/speech için kısa deneme gövdesi
{
"model": "google/gemini-2.5-pro-preview-tts",
"input": "Merhaba. Bu kısa kayıt, seslendirme kontrolü için hazırlanmıştır.",
"voice": "Kore"
}Yönlendirme metnini gerçekten dinleyin
Sakin, açık veya daha yavaş okuma gibi bir yönlendirme eklediğinizde yalnızca talimatın yazılmış olmasına güvenmeyin. Kayıtta beklenen etkiyi duyduğunuzu doğrulayın. Yönlendirme cümlesinin kendisinin okunması, yanlış yerde kullanıldığına veya isteğin beklediğiniz biçimde anlaşılmadığına işaret edebilir. Seçtiğiniz modelin belgelenmiş biçimi dışında alan uydurmayın.
Aynı anda ses, metin, hız isteği ve noktalama değiştirmek karşılaştırmayı zorlaştırır. Önce metni sabitleyin, sonra tek bir tercihi değiştirin. Telaffuzu düzeltmek için özel adın yazımını bozuyorsanız bu metni kullanıcıya görünen özgün metnin yerine koymayın. Ses üretimi için kullanılan yardımcı yazımla yayımlanan içerik ayrı tutulmalı; anlam ve marka adı son kontrolde korunmalı.
İki dili ayrı bir dinleme tablosunda inceleyin
Türkçe ve İspanyolca kayıtları o dili anlayan bir dinleyiciyle kontrol edin. Akıcı ses, doğru sayı veya doğru özel ad demek değildir. Özellikle tarih, ondalık tutar, kısa kod ve kısaltmaları işaretleyin. Aynı ses karakterinin iki dilde aynı telaffuz davranışını vereceğini varsaymayın. Her dil kendi kabul koşulunu geçmeli.
Dinleme kaydında sorunlu bölümün zamanını belirtin. Böylece düzeltme için bütün metni yeniden incelemek gerekmez. Başarılı ve başarısız kayıtları yalnızca dosya adına göre ayırmak yerine metin sürümü ve model kimliğiyle eşleştirin. İkinci denemede başka bir metin kullanıp daha iyi ses aldığınızda bunun ilk metindeki sorunu çözdüğünü söylemeyin.
| Alan | Kontrol sorusu |
|---|---|
| Anlam | Metnin bir bölümü atlandı mı? |
| Özel ad | Ad doğru ve tutarlı okundu mu? |
| Sayı | Tarih ve tutar anlaşılır mı? |
| Ritim | Duraklar cümle anlamını koruyor mu? |
| Dosya | Başlangıç, bitiş ve oynatma sorunsuz mu? |
Uzun metni yalnızca onaylı kısa örnekten sonra üretin
Kısa kayıt kabul edildikten sonra metni doğal bölüm sınırlarından ayırın. Cümleyi ortadan bölmek veya sayı ile birimini farklı parçalara koymak dinleme deneyimini bozabilir. Parçalar arasında aynı ses seçimini ve yazım tercihlerini koruyun. Birleştirilmiş kaydı da baştan sona dinleyin; tek tek iyi parçalar birleşince tekrar veya kopukluk oluşabilir.
Maliyeti yalnızca son dosyanın süresinden tahmin etmeyin. Kullanılan modelin fiyatlandırma birimini ve denemelerin kullanımını kontrol edin; yeniden üretimler de hesaba girer. Preview modelle kurulan iş akışında sürüm ve tarih kaydı tutun. Yeni modele geçişte iki dili tekrar test edin. Önceki modelin dinleme onayı sonraki model için otomatik onay değildir.
Sık sorulan sorular
Gemini TTS isteğinde voice gerekli mi?
Evet. LLMTR’de Gemini TTS için voice alanı zorunludur; eksik istek 400 ile reddedilir.
İspanyolca metni TTS sırasında mı çevirmeliyim?
Bu rehber önce çeviriyi yazılı olarak doğrulamanızı, sonra ses üretmenizi önerir. Böylece çeviri ve telaffuz hataları ayrılabilir.
Burada iki dilde ses kalitesi ölçüldü mü?
Hayır. Yazı bir üretim ve kontrol yöntemi sunuyor. Kendi metninizi üreterek iki dili ayrı dinleme kontrolünden geçirin.