Kurulum ve veri üretimi

Stream Ember locale-catalog listesini Google Cloud Text-to-Speech ve Google Cloud Translation servisleriyle eşleştiren PHP/JSON katalog projesidir.

#Kurulum

google-language-catalog klasörünü aşağıdaki konuma yükleyin:

https://api.streamember.com/google-language-catalog/

Ek paket veya Composer bağımlılığı yoktur. PHP tarafında curl uzantısı önerilir; uzantı yoksa allow_url_fopen üzerinden HTTP isteği denenir.

#Adresler

/index.php                     Ana dil ve servis kataloğu
/index.json                    Katalog manifesti
/tts/                          Filtrelenebilir TTS sesleri
/tts/synthesize.php            Metinden ses üretimi
/translate/                    Çeviri dilleri
/translate/text.php            Metin çevirisi
/preview/                      TTS ve çeviri deneme arayüzü
/data/google-languages.json    Locale → Google eşleştirmeleri
/data/tts-voices.json          TTS ses kataloğu
/data/models.json              Model özellikleri

#TTS filtreleri

/tts/?locale=tr-TR
/tts/?locale=tr-TR&tier=Standard
/tts/?locale=tr-TR&tier=Premium
/tts/?locale=tr-TR&model=Chirp3-HD
/tts/?locale=tr-TR&model=Standard&gender=FEMALE
/tts/?q=Aoede&page=1&perPage=100

Seslerin name alanı kısa biçimdedir:

{
  "name": "Standard-A",
  "apiName": "tr-TR-Standard-A"
}

Google isteğinde kullanılabilmesi için tam ad ayrıca apiName alanında tutulur.

Gemini-TTS kayıtlarında ses adı Kore, Charon gibi genel bir addır. Kullanılacak gerçek Gemini modeli modelName alanıyla seçilir. Katalog şu model kimliklerini tanır:

gemini-3.1-flash-tts-preview
gemini-2.5-flash-tts
gemini-2.5-flash-lite-preview-tts
gemini-2.5-pro-tts

#TTS isteği

POST /tts/synthesize.php
Content-Type: application/json

{
  "text": "Merhaba, bu bir ses denemesidir.",
  "voice": "tr-TR-Standard-A",
  "languageCode": "tr-TR",
  "audioEncoding": "MP3"
}

voice alanında aynı dil içinde benzersiz olduğu sürece Standard-A kısa adı da kullanılabilir.

#Translate isteği

POST /translate/text.php
Content-Type: application/json

{
  "text": "Merhaba dünya",
  "source": "tr",
  "target": "en"
}

Kaynak dilin otomatik belirlenmesi için source alanını auto gönderebilir veya hiç göndermeyebilirsiniz.

#Google Cloud gereksinimleri

API anahtarının bağlı olduğu Google Cloud projesinde Text-to-Speech ve Translation API servisleri etkin, faturalandırma açık olmalıdır. Standard, WaveNet, Neural2, Chirp ve Studio istekleri API anahtarıyla kullanılabilir. Gemini-TTS ayrıca Google tarafında aiplatform.endpoints.predict izni ve uygun kimlik doğrulama isteyebilir; bu durumda önizleme ekranı Google'ın döndürdüğü açıklamayı doğrudan gösterir.

#Katalog verisini yeniden üretme

Google ses tablosunun HTML içeriği ve güncel locale kataloğu kullanılarak statik veriler tekrar üretilebilir:

python generate_catalog.py locale-index.json google-voices-table.html

Bu işlem data klasöründeki JSON dosyalarını ve kökteki index.json manifestini günceller.