Deteksi bahasa dengan AI bawaan

Thomas Steiner

Dipublikasikan: 24 September 2024, Terakhir diperbarui: 20 Mei 2025

Browser Support

• 138
• 148
• x
• x

Source

Sebelum menerjemahkan teks dari satu bahasa ke bahasa lain, Anda harus menentukan terlebih dahulu bahasa yang digunakan dalam teks yang diberikan. Sebelumnya, terjemahan memerlukan upload teks ke layanan cloud, melakukan terjemahan di server, lalu mendownload hasilnya.

Language Detector API berfungsi di sisi klien, yang berarti Anda dapat melindungi privasi pengguna. Meskipun Anda dapat mengirimkan library tertentu yang melakukan hal ini, Anda akan memerlukan resource tambahan untuk mendownloadnya.

Kapan harus menggunakan deteksi bahasa

Language Detector API sangat berguna dalam skenario berikut:

• Menentukan bahasa teks input, sehingga dapat diterjemahkan.
• Menentukan bahasa teks input, sehingga model yang benar dapat dimuat untuk tugas khusus bahasa, seperti deteksi toksisitas.
• Menentukan bahasa teks input, sehingga dapat diberi label dengan benar, misalnya, di situs jejaring sosial online.
• Menentukan bahasa teks input, sehingga antarmuka aplikasi dapat disesuaikan. Misalnya, di situs Belgia, hanya menampilkan antarmuka yang relevan bagi pengguna yang berbicara bahasa Prancis.

Mulai

Language Detector API dan Translator API berfungsi di Chrome di desktop. API ini tidak berfungsi di perangkat seluler.

Jalankan deteksi fitur untuk melihat apakah browser mendukung Language Detector API.

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

Tips: Gunakan paket npm @types/dom-chromium-ai untuk mendapatkan pengetikan TypeScript untuk Prompt API dan API AI bawaan lainnya agar lebih mudah diakses di codebase Anda.

Download model

Deteksi bahasa bergantung pada model yang disesuaikan untuk tugas tertentu dalam mendeteksi bahasa. Meskipun API di-build di browser, model didownload on-demand saat pertama kali situs mencoba menggunakan API. Di Chrome, model ini sangat kecil dibandingkan dengan model lainnya. Model ini mungkin sudah ada, karena digunakan oleh fitur Chrome lainnya.

Untuk menentukan apakah model siap digunakan, panggil fungsi LanguageDetector.availability() asinkron. Jika respons terhadap availability() adalah downloadable, proses progres download dan beri tahu pengguna, karena download mungkin memerlukan waktu.

Untuk memicu download dan membuat instance pendeteksi bahasa, periksa aktivasi pengguna. Kemudian, panggil fungsi LanguageDetector.create() asinkron.

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

Menjalankan pendeteksi bahasa

Language Detector API menggunakan model peringkat untuk menentukan bahasa yang paling mungkin digunakan dalam teks tertentu. Pemeringkatan adalah jenis machine learning, yang tujuannya adalah mengurutkan daftar item. Dalam hal ini, Language Detector API memberi peringkat bahasa dari probabilitas tertinggi hingga terendah.

Catatan: Language Detector API dilatih pada serangkaian bahasa, yang tidak sepenuhnya mencakup setiap bahasa yang ada. Artinya, API tidak dapat mendeteksi setiap bahasa dengan akurasi penuh. Mulai Chrome 132, Anda dapat memeriksa apakah bahasa tertentu tersedia untuk dideteksi.

Fungsi detect() dapat menampilkan hasil pertama, jawaban yang paling mungkin, atau melakukan iterasi pada kandidat yang diberi peringkat dengan tingkat keyakinan. Hasil ini ditampilkan sebagai daftar objek {detectedLanguage, confidence}. Tingkat confidence dinyatakan sebagai nilai antara 0.0 (keyakinan terendah) dan 1.0 (keyakinan tertinggi).

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
// ...

Perhatian: Frasa yang sangat pendek dan kata tunggal harus dihindari, karena akurasi hasilnya akan rendah. Jika Anda biasanya bekerja dengan teks yang lebih pendek, bereksperimenlah dengan bahasa prioritas Anda, tinjau keyakinan yang dilaporkan, dan tampilkan hasilnya sebagai tidak diketahui jika keyakinannya terlalu rendah.

API playground

Bereksperimenlah dengan Language Detector API di playground API kami. Masukkan teks yang ditulis dalam berbagai bahasa di area teks.

Kebijakan Izin, iframe, dan Web Worker

Secara default, Language Detector API hanya tersedia untuk jendela tingkat atas dan iframe dengan asal yang sama. Akses ke API dapat didelegasikan ke iframe lintas origin menggunakan atribut allow="" Kebijakan Izin:

<!--
  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 tidak tersedia di Web Worker. Hal ini disebabkan oleh kompleksitas dalam menetapkan dokumen yang bertanggung jawab untuk setiap pekerja guna memeriksa status Kebijakan Izin.

Beri masukan

Kami ingin melihat apa yang Anda buat dengan Language Detector API. Bagikan situs dan aplikasi web Anda kepada kami di X, YouTube, dan LinkedIn.

Jika Anda memiliki masukan tentang penerapan Chrome, laporkan bug Chromium.

Bergabunglah dengan Program Pratinjau Awal untuk melihat lebih awal API AI bawaan baru dan mengakses diskusi di milis kami.