Translator and Language Detector APIs

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Mehr erfahren
Vollständige Kompatibilität anzeigen

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die Translator- und Sprachenerkennungs-APIs bieten Funktionalitäten, um die Sprache von Texten zu erkennen und Texte in verschiedene Sprachen zu übersetzen, mittels des internen KI-Modells eines Browsers (das zwischen den Browsern variieren kann).

Konzepte und Nutzung

Die Übersetzung eines Textkorpus ist eine häufige Aufgabe im heutigen Web. Typische Anwendungsfälle sind:

Die sofortige Übersetzung eines Artikels, der nicht in Ihrer Sprache verfügbar ist.
Die Übersetzung von Benutzeranfragen in eine Sprache, die der Support-Agent versteht.
Die Ermöglichung von Chats zwischen Benutzern, die nicht die gleiche Sprache sprechen.

Die Erkennung der Sprache eines Textkorpus ist eine wichtige Voraussetzung für eine erfolgreiche automatische Übersetzung, hat aber auch andere Anwendungen jenseits der direkten Übersetzung. Zum Beispiel ermöglicht sie die automatische Konfiguration der Benutzeroberfläche basierend auf der Texteingabe des Benutzers, angefangen von der Aktualisierung von UI- und Fehlermeldungstexten bis hin zum automatischen Laden geeigneter Wörterbücher für die Rechtschreibprüfung oder Fluchworterkennung.

KI eignet sich gut zur Unterstützung der Spracherkennung und Übersetzung. Die Translator- und Sprachenerkennungs-APIs bieten asynchrone (Promise-basierte) Mechanismen für eine Website, um Sprachen zu erkennen und Texte über das eigene interne KI-Modell des Browsers zu übersetzen. Dies ist nützlich und effizient, da der Browser den Dienst verarbeitet und nicht der Entwickler darauf angewiesen ist, dass der Benutzer KI-Modelle herunterlädt, oder dass der Entwickler einen cloudbasierten Übersetzungsdienst hosten oder dafür bezahlen muss.

Die Spracherkennung erfolgt über das LanguageDetector-Interface. Eine Instanz eines LanguageDetector-Objekts wird mit der statischen Methode LanguageDetector.create() erstellt, dann wird die Instanzmethode detect() aufgerufen, um die Sprache für den zu erkennenden Text zu übermitteln.
Die Übersetzung erfolgt über das Translator-Interface. Eine Instanz eines Translator-Objekts wird mit der statischen Methode Translator.create() erstellt, dann wird die Instanzmethode translate() aufgerufen, um den zu übersetzenden Text zu übermitteln.

Sie können eine ausstehende create(), detect(), oder translate()-Operation mit einem AbortController abbrechen.

Nachdem eine LanguageDetector- oder Translator-Instanz erstellt wurde, können Sie ihre zugewiesenen Ressourcen freigeben und jegliche weitere Aktivität stoppen, indem Sie ihre Methoden LanguageDetector.destroy()/Translator.destroy() aufrufen. Es wird empfohlen, dies zu tun, nachdem Sie das Objekt nicht mehr benötigen, da es viele Ressourcen verbrauchen kann.

Siehe Verwendung der Translator- und Sprachenerkennungs-APIs für eine Anleitung zur Verwendung der APIs.

Schnittstellen

CreateMonitor: Bietet Informationen über den Fortschritt eines KI-Modelldownloads, zum Beispiel eines Sprachpakets oder einiger Feinabstimmungsdaten.
LanguageDetector: Enthält alle Funktionen zur Spracherkennung, einschließlich der Überprüfung der Verfügbarkeit des KI-Modells, der Erstellung einer neuen LanguageDetector-Instanz, der Verwendung zur Spracherkennung und mehr.
Translator: Enthält alle Übersetzungsfunktionen, einschließlich der Überprüfung der Verfügbarkeit des KI-Modells, der Erstellung einer neuen Translator-Instanz, der Verwendung zur Erstellung einer Übersetzung und mehr.

HTTP-Header

Permissions-Policy; die language-detector-Direktive: Kontrolliert den Zugang zur Spracherkennungsfunktionalität. Wo eine Richtlinie die Nutzung speziell untersagt, wird die statische Methode LanguageDetector.availability() unavailable zurückgeben, und alle Versuche, andere LanguageDetector-Methoden aufzurufen, werden mit einem NotAllowedError DOMException fehlschlagen.
Permissions-Policy; die translator-Direktive: Kontrolliert den Zugang zur Übersetzungsfunktionalität. Wo eine Richtlinie die Nutzung speziell untersagt, wird die statische Methode Translator.availability() unavailable zurückgeben, und alle Versuche, andere Translator-Methoden aufzurufen, werden mit einem NotAllowedError DOMException fehlschlagen.