Yerleşik yapay zeka ile dil algılama

Yayınlanma tarihi: 24 Eylül 2024, Son güncelleme tarihi: 20 Mayıs 2025

Browser Support

  • Chrome: 138.
  • Edge: not supported.
  • Firefox: not supported.
  • Safari: not supported.

Source

Metni bir dilden başka bir dile çevirmeden önce, metinde hangi dilin kullanıldığını belirlemeniz gerekir. Daha önce çeviri için metnin bir bulut hizmetine yüklenmesi, çevirinin sunucuda yapılması ve sonuçların indirilmesi gerekiyordu.

Language Detector API, istemci tarafında çalıştığı için kullanıcı gizliliğini koruyabilirsiniz. Bunu yapan belirli bir kitaplığı göndermek mümkün olsa da indirmek için ek kaynaklar gerekir.

Dil algılama ne zaman kullanılır?

Language Detector API, öncelikle aşağıdaki senaryolarda yararlıdır:

  • Giriş metninin dilini belirleyerek çevrilmesini sağlar.
  • Giriş metninin dilini belirleyerek zehirli içerik algılama gibi dile özgü görevler için doğru modelin yüklenmesini sağlar.
  • Giriş metninin dilini belirleyerek metnin doğru şekilde etiketlenmesini sağlar. Örneğin, online sosyal ağ sitelerinde bu özellikten yararlanılabilir.
  • Giriş metninin dilini belirleyerek uygulamanın arayüzünün buna göre ayarlanmasını sağlar. Örneğin, Belçika'daki bir sitede yalnızca Fransızca konuşan kullanıcılarla alakalı arayüzü göstermek için.

Başlayın

Donanım gereksinimlerini inceleyin

Geliştiriciler ve Chrome'da bu API'leri kullanarak özellikleri çalıştıran kullanıcılar için aşağıdaki şartlar geçerlidir. Diğer tarayıcıların farklı işletim gereksinimleri olabilir.

Dil Algılayıcı ve Çeviri API'leri, masaüstü Chrome'da çalışır. Bu API'ler mobil cihazlarda çalışmaz.

Prompt API, Summarizer API, Writer API, Rewriter API ve Proofreader API, aşağıdaki koşullar karşılandığında Chrome'da çalışır:

  • İşletim sistemi: Windows 10 veya 11; macOS 13+ (Ventura ve sonraki sürümler); Linux; ya da Chromebook Plus cihazlarda ChromeOS (Platform 16389.0.0 ve sonraki sürümler). Android, iOS ve Chromebook Plus olmayan cihazlarda ChromeOS için Gemini Nano'yu kullanan API'ler henüz desteklenmemektedir.
  • Depolama: Chrome profilinizi içeren birimde en az 22 GB boş alan olmalıdır.
  • GPU veya CPU: Yerleşik modeller GPU veya CPU ile çalışabilir.
    • GPU: Kesinlikle 4 GB'tan fazla VRAM.
    • CPU: 16 GB veya daha fazla RAM ve 4 veya daha fazla CPU çekirdeği.
    • Not: Ses girişi içeren Prompt API için GPU gerekir.
  • : Sınırsız veri veya ölçülmemiş bağlantı.

Tarayıcı modeli güncellediğinden Gemini Nano'nun tam boyutu değişebilir. Mevcut boyutu belirlemek için chrome://on-device-internals adresini ziyaret edin.

Tarayıcının Language Detector API'yi destekleyip desteklemediğini görmek için özellik algılama işlemini çalıştırın.

if ('LanguageDetector' in self) {
  // The Language Detector API is available.
}

Model indirme

Dil algılama, dilleri algılama görevine göre hassas şekilde ayarlanmış bir modele bağlıdır. API tarayıcıda yerleşik olsa da model, bir site API'yi ilk kez kullanmaya çalıştığında isteğe bağlı olarak indirilir. Chrome'da bu model, diğer modellerle karşılaştırıldığında çok küçüktür. Bu model diğer Chrome özellikleri tarafından kullanıldığından zaten mevcut olabilir.

Modelin kullanıma hazır olup olmadığını belirlemek için eşzamansız LanguageDetector.availability() işlevini çağırın. availability() yanıtı downloadable ise indirme işleminin ilerleme durumunu dinleyin ve indirme işlemi zaman alabileceği için kullanıcıyı bilgilendirin.

İndirme işlemini tetiklemek ve dil algılayıcıyı başlatmak için kullanıcı etkinleştirme olup olmadığını kontrol edin. Ardından, eşzamansız LanguageDetector.create() işlevini çağırın.

const detector = await LanguageDetector.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
});

Dil algılayıcıyı çalıştırma

Language Detector API, belirli bir metinde hangi dilin kullanılma olasılığının en yüksek olduğunu belirlemek için bir sıralama modeli kullanır. Sıralama, makine öğrenimi türlerinden biridir. Amaç, öğe listesini sıralamaktır. Bu durumda, Dil Algılama API'si dilleri en yüksek olasılıktan en düşük olasılığa doğru sıralar.

detect() işlevi, ilk sonucu, en olası yanıtı döndürebilir veya güven düzeyine göre sıralanmış adayları yineleyebilir. Bu, {detectedLanguage, confidence} nesnelerinin listesi olarak döndürülür. confidence düzeyi, 0.0 (en düşük güven) ile 1.0 (en yüksek güven) arasında bir değer olarak ifade edilir.

const someUserText = 'Hallo und herzlich willkommen!';
const results = await detector.detect(someUserText);
for (const result of results) {
  // Show the full list of potential languages with their likelihood, ranked
  // from most likely to least likely. In practice, one would pick the top
  // language(s) that cross a high enough threshold.
  console.log(result.detectedLanguage, result.confidence);
}
// (Output truncated):
// de 0.9993835687637329
// en 0.00038279531872831285
// nl 0.00010798392031574622
// ...

API atölyesi

API playground'umuzda Language Detector API ile denemeler yapın. Metin alanına farklı dillerde yazılmış metinler girin.

İzin politikası, iframe'ler ve Web Workers

Dil Algılayıcı API varsayılan olarak yalnızca üst düzey pencerelerde ve bunların aynı kaynaklı iFrame'lerinde kullanılabilir. API'ye erişim, Permission Policy allow="" özelliği kullanılarak kaynaklar arası iframe'lere devredilebilir:

<!--
  The hosting site at https://main.example.com can grant a cross-origin iframe
  at https://cross-origin.example.com/ access to the Language Detector API by
  setting the `allow="language-detector"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="language-detector"></iframe>

Language Detector API, Web Workers'da kullanılamaz. Bunun nedeni, İzin Politikası durumunu kontrol etmek için her çalışan adına sorumlu bir belge oluşturmanın karmaşık olmasıdır.

Görüşlerinizi paylaşın

Language Detector API ile neler geliştirdiğinizi görmek istiyoruz. Web sitelerinizi ve web uygulamalarınızı X, YouTube ve LinkedIn'de bizimle paylaşın.

Chrome'un uygulamasıyla ilgili geri bildiriminiz varsa Chromium hata bildiriminde bulunun.

Yeni yerleşik yapay zeka API'lerine erken erişim ve posta listemizdeki tartışmalara katılmak için Erken Önizleme Programı'na katılın.