Chrome AI Translator Playground
Testen Sie die experimentelle Chrome-integrierte Translator- und Language Detector Web APIs direkt in Ihrem Browser. Übersetzen Sie Text auf dem Gerät, erkennen Sie die Quellsprache automatisch, beobachten Sie den Fortschritt des Modelldownloads und überprüfen Sie die Konfidenz der Spracherkennung — ohne Server erforderlich.
Eingabe
Ausgabe
Readme
Was ist Chromes integrierte Translator API?
Die Translator API ist eine experimentelle Web-Plattform-Funktion, die es einer Webseite ermöglicht, Text direkt im Browser zu übersetzen, indem sie ein lokal gebündeltes KI-Modell verwendet, das vom User Agent verwaltet wird. Anstatt Text an einen Remote-Übersetzungsdienst zu senden, stellt der Browser eine JavaScript-Schnittstelle (window.Translator) bereit, die kurzlebige Übersetzer-Sitzungen für ein bestimmtes Quell-/Zielsprachenpaar erstellt und übersetzte Strings asynchron zurückgibt.
Die begleitende Language Detector API (window.LanguageDetector) untersucht einen String und gibt eine sortierte Liste wahrscheinlicher BCP-47-Sprach-Tags mit Konfidenzwerten zurück. Zusammen ermöglichen die beiden APIs einer Seite, die Sprache beliebiger Eingaben zu erkennen und sie dann ohne Netzwerk-Roundtrip nach dem initialen Modell-Download zu übersetzen.
Da das Modell auf dem Gerät des Benutzers ausgeführt wird, funktionieren Übersetzungen offline, sobald sie heruntergeladen sind, sensible Texte verlassen die Maschine nie, und es gibt keine Pro-Anfrage-API-Kosten. Der Kompromiss besteht darin, dass die Verfügbarkeit vom Browser, dem Betriebssystem und davon abhängt, ob das angeforderte Sprachenpaar heruntergeladen wurde.
Werkzeugbeschreibung
Dieser Playground ist eine praktische Umgebung zum Testen der Translator und Language Detector APIs in Ihrem eigenen Browser. Er verbindet einen Eingabebereich, einen Zielsprachen-Selector und einen Ausgabebereich mit den zugrunde liegenden Translator.create() / translate()-Aufrufen und zeigt den Verfügbarkeitsstatus und den Download-Fortschritt des Modells während des Experimentierens an.
Die Ausgangssprache ist standardmäßig auf „Automatisch erkennen" eingestellt, was die Eingabe zuerst durch LanguageDetector leitet und dann die erkannte Sprache an den Übersetzer weiterleitet. Sie können die Ausgangssprache auch explizit festlegen, um die Erkennung zu überspringen.
Beispiele
| Quelle (automatisch erkannt) | Ziel | Ausgabe |
|---|---|---|
Bonjour, comment ça va ? |
English | Hello, how are you? |
Guten Morgen, wie geht es dir? |
Spanish | Buenos días, ¿cómo estás? |
今日は良い天気ですね。 |
English | The weather is nice today. |
Funktionen
- Automatische Spracherkennung — verwendet die Language Detector API, um die Ausgangssprache vor der Übersetzung zu identifizieren.
- Bidirektionaler Sprachen-Picker — tauschen Sie Quell- und Zielsprache mit einem Klick aus und übersetzen Sie erneut.
- Live-Verfügbarkeitsstatus — zeigt an, ob das angeforderte Modell
available,downloadable,downloadingoderunavailableist. - Download-Fortschrittsleiste — streamt
downloadprogress-Events vom Übersetzer/Detektor, während das Modell abgerufen wird. - On-Device, Offline-Übersetzung — sobald das Modell heruntergeladen ist, werden keine Netzwerkanfragen zum Übersetzen gestellt.
Anwendungsfälle
- Vorschau lokalisierter Kopien — fügen Sie einen String ein und sehen Sie sofort, wie er in einer anderen Sprache gelesen wird, während Sie UI-Text verfassen.
- Überprüfung der Browser-Unterstützung — prüfen Sie, ob ein bestimmtes Quell-/Ziel-Paar verfügbar ist, bevor Sie eine Funktion ausliefern, die von der Translator API abhängt.
- Schnelle Offline-Übersetzung — übersetzen Sie Snippets ohne Verbindung, nachdem das relevante Sprachpaket heruntergeladen wurde.
Anforderungen
- Ein Browser, der die Translator und Language Detector APIs implementiert. Zum Zeitpunkt des Schreibens ist dies Chrome 138+ und Chromium-basierte Browser (z. B. Opera 122+) auf dem Desktop. Edge, Firefox und Safari werden noch nicht unterstützt.
- Ein sicherer Kontext (HTTPS oder
localhost). - Transiente Benutzeraktivierung — die APIs erlauben
create()nur nach einer kürzlichen Benutzergeste, weshalb die Übersetzung bei Eingabe statt beim Laden der Seite ausgeführt wird. - Ausreichend Speicherplatz und Bandbreite für den initialen Sprachmodell-Download. Nachfolgende Übersetzungen verwenden das gecachte Modell erneut.
Funktionsweise
- Bei der Bereitstellung prüft das Werkzeug auf
window.Translatorundwindow.LanguageDetector. Wenn eines fehlt, wird eine Warnung angezeigt und die Eingabe deaktiviert. - Wenn Sie tippen, wird die Eingabe entprellt und das Quell-/Ziel-Paar wird aufgelöst (zuerst
LanguageDetector.detect()ausführen, wenn die Quelleautoist). Translator.availability({ sourceLanguage, targetLanguage })wird aufgerufen, um den Modellstatus für dieses Paar abzufragen.Translator.create()wird mit einemmonitor-Callback aufgerufen, der aufdownloadprogress-Events lauscht und die Fortschrittsleiste aktualisiert.translator.translate(text)gibt den übersetzten String zurück, der im Ausgabebereich gerendert wird.- Die Übersetzer- und Detektor-Instanzen werden nach jedem Aufruf über
destroy()freigegeben, um Ressourcen freizugeben.
Unterstützte Sprachen
Der Picker zeigt eine kuratierte Liste häufiger BCP-47-Sprach-Tags, die Chromes gebündeltes Modell unterstützt oder häufig testet, einschließlich:
en, es, fr, de, it, pt, nl, pl, ru, uk, tr, ar, hi, bn, ja, ko, zh, zh-Hant, vi, th, id, sv, no, fi, da, el, he, cs, ro, hu.
Der tatsächliche Satz verwendbarer Paare hängt davon ab, welche das zugrunde liegende Browser-Modell heruntergeladen hat oder herunterladen kann. Paare, die als unavailable gemeldet werden, können in Ihrem aktuellen Browser nicht übersetzt werden.
Einschränkungen
- Die APIs sind experimentell und die Oberfläche kann sich zwischen Browser-Versionen ändern.
- Die Übersetzungsqualität wird durch das vom Browser bereitgestellte Modell bestimmt und ist nicht garantiert, um dedizierten Cloud-Übersetzungsdiensten zu entsprechen.
- Einige Sprachenpaare erfordern möglicherweise einen Zwischenschritt über Englisch oder sind einfach nicht verfügbar.
- Die erste Übersetzung für ein neues Sprachenpaar kann aufgrund des Modell-Downloads langsam sein.
- Die APIs sind derzeit nicht für Web Worker verfügbar und können durch eine Permissions Policy (
translator,language-detector) auf Cross-Origin-iframes gated sein.
Häufig gestellte Fragen
Warum bleibt die Ausgabe leer? Die Translator API ist wahrscheinlich nicht in Ihrem Browser implementiert. Öffnen Sie die Seite in Chrome 138+ auf dem Desktop und laden Sie sie neu.
Warum wird „Modell wird heruntergeladen…" angezeigt?
Wenn Sie ein Sprachenpaar zum ersten Mal verwenden, lädt der Browser ein Modellpaket herunter. Die Fortschrittsleiste spiegelt die downloadprogress-Events wider, die von Translator.create() emittiert werden.
Verlässt mein Text das Gerät? Nein. Nach dem Herunterladen des Modells erfolgt die Übersetzung vollständig auf dem Gerät. Das Werkzeug selbst sendet Ihre Eingabe nirgendwo hin.
Warum schlägt „Automatisch erkennen" manchmal fehl?
Wenn die Eingabe zu kurz, mehrdeutig oder in einem Skript ist, das der Detektor nicht gesehen hat, kann LanguageDetector.detect() und (undetermined) zurückgeben. Wählen Sie in diesem Fall die Ausgangssprache manuell aus.