Veröffentlicht am 24. September 2024, letzte Aktualisierung: 20. Mai 2025
Bevor Sie Text von einer Sprache in eine andere übersetzen, müssen Sie zuerst die Sprache des Texts ermitteln. Bisher war für die Übersetzung erforderlich, den Text in einen Clouddienst hochzuladen, die Übersetzung auf dem Server durchzuführen und dann die Ergebnisse herunterzuladen.
Die Language Detector API funktioniert clientseitig, sodass Sie die Privatsphäre der Nutzer schützen können. Es ist zwar möglich, eine bestimmte Bibliothek zu verwenden, die dies tut, aber für den Download sind zusätzliche Ressourcen erforderlich.
Wann ist die Spracherkennung sinnvoll?
Die Language Detector API ist in folgenden Szenarien besonders nützlich:
- Sprache des Eingabetexts ermitteln, damit er übersetzt werden kann.
- Sprache des Eingabetexts ermitteln, damit das richtige Modell für sprachspezifische Aufgaben wie die Erkennung von schädlichen Inhalten geladen werden kann.
- Sprache des Eingabetexts ermitteln, damit er richtig gekennzeichnet werden kann, z. B. in sozialen Netzwerken.
- Sprache des Eingabetexts ermitteln, damit die Benutzeroberfläche einer App entsprechend angepasst werden kann. Beispielsweise auf einer belgischen Website, um nur die Benutzeroberfläche für Nutzer anzuzeigen, die Französisch sprechen.
Jetzt starten
Hardwareanforderungen prüfen
Die folgenden Anforderungen gelten für Entwickler und Nutzer, die diese APIs in Chrome verwenden. Bei anderen Browsern gelten möglicherweise andere Betriebsanforderungen.
Die Language Detector API und die Translator API funktionieren in Chrome auf dem Computer. Auf Mobilgeräten funktionieren diese APIs nicht.
Die Prompt API, Summarizer API, Writer API, Rewriter API und Proofreader API funktionieren in Chrome, wenn die folgenden Bedingungen erfüllt sind:
- Betriebssystem: Windows 10 oder 11, macOS 13 oder höher (Ventura und höher), Linux oder ChromeOS (ab Plattform 16389.0.0) auf Chromebook Plus-Geräten. Chrome für Android, iOS und ChromeOS auf Nicht-Chromebook Plus-Geräten wird von den APIs, die Gemini Nano verwenden, noch nicht unterstützt.
- Speicher: Mindestens 22 GB freier Speicherplatz auf dem Volume, das Ihr Chrome-Profil enthält.
- GPU oder CPU: Integrierte Modelle können mit GPU oder CPU ausgeführt werden.
- GPU: Mehr als 4 GB VRAM.
- CPU: Mindestens 16 GB RAM und mindestens 4 CPU-Kerne.
- Hinweis: Für die Prompt API mit Audioeingabe ist eine GPU erforderlich.
- Netzwerk: Unbegrenzte Daten oder eine nicht getaktete Verbindung.
Die genaue Größe von Gemini Nano kann variieren, da das Modell vom Browser aktualisiert wird. Die aktuelle Größe finden Sie unter chrome://on-device-internals.
Führen Sie die Funktionserkennung aus, um zu prüfen, ob der Browser die Language Detector API unterstützt.
if ('LanguageDetector' in self) {
// The Language Detector API is available.
}
Download des Modells
Die Spracherkennung basiert auf einem Modell, das für die spezifische Aufgabe der Spracherkennung optimiert ist. Die API ist zwar im Browser integriert, das Modell wird aber erst heruntergeladen, wenn eine Website die API zum ersten Mal verwendet. In Chrome ist dieses Modell im Vergleich zu anderen Modellen sehr klein. Es ist möglicherweise bereits vorhanden, da dieses Modell von anderen Chrome-Funktionen verwendet wird.
Rufen Sie die asynchrone
LanguageDetector.availability()
Funktion auf, um zu prüfen, ob das Modell einsatzbereit ist. Wenn die Antwort auf availability() downloadable war, beobachten Sie den Downloadfortschritt und informieren Sie den Nutzer, da der Download einige Zeit dauern kann.
Prüfen Sie, ob der Nutzer die Funktion aktiviert hat, um den Download auszulösen und den Spracherkenner zu instanziieren. Rufen Sie dann die asynchrone Funktion LanguageDetector.create() auf.
const detector = await LanguageDetector.create({
monitor(m) {
m.addEventListener('downloadprogress', (e) => {
console.log(`Downloaded ${e.loaded * 100}%`);
});
},
});
Spracherkenner ausführen
Die Language Detector API verwendet ein Rankingmodell, um zu ermitteln, welche Sprache in einem bestimmten Text am wahrscheinlichsten verwendet wird. Ranking ist eine Art des maschinellen Lernens, bei der eine Liste von Elementen sortiert werden soll. In diesem Fall ordnet die Language Detector API Sprachen nach der Wahrscheinlichkeit von der höchsten zur niedrigsten.
Die Funktion detect() kann entweder das erste Ergebnis, die wahrscheinlichste Antwort zurückgeben oder die sortierten Kandidaten mit dem Konfidenzniveau durchlaufen.
Dies wird als Liste von {detectedLanguage, confidence}-Objekten zurückgegeben. Das confidence-Niveau wird als Wert zwischen 0.0 (niedrigste Konfidenz) und 1.0 (höchste Konfidenz) ausgedrückt.
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-Spielplatz
Testen Sie die Language Detector API auf unserem API-Spielplatz. Geben Sie Text in verschiedenen Sprachen in das Textfeld ein.
Berechtigungsrichtlinie, iFrames und Web Worker
Standardmäßig ist die Language Detector API nur für Fenster der obersten Ebene und für ihre iFrames mit derselben Quelle verfügbar. Der Zugriff auf die API kann mithilfe des Attributs der Berechtigungsrichtlinie an iFrames mit unterschiedlichen Quellen delegiert werden:
allow=""
<!--
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>
Die Language Detector API ist in Web Workern nicht verfügbar. Das liegt daran, dass es komplex ist, für jeden Worker ein verantwortliches Dokument zu erstellen, um den Status der Berechtigungsrichtlinie zu prüfen.
Feedback geben
Wir möchten sehen, was Sie mit der Language Detector API entwickeln. Teilen Sie uns Ihre Websites und Webanwendungen auf X, YouTube, und LinkedIn mit.
Wenn Sie Feedback zur Implementierung von Chrome haben, erstellen Sie in Chromium einen Eintrag für das Problem.
Nehmen Sie am Early Preview Program teil um einen frühen Einblick in neue integrierte KI-APIs zu erhalten und auf unserer Mailingliste mit anderen zu diskutieren.