Chrome AI Translator Playground

Wat is Chrome's ingebouwde Translator API?

De Translator API is een experimentele webplatformfunctie waarmee een webpagina tekst rechtstreeks in de browser kan vertalen met behulp van een lokaal gebundeld AI-model dat door de user agent wordt beheerd. In plaats van tekst naar een externe vertaalservice te sturen, stelt de browser een JavaScript-interface (window.Translator) beschikbaar die kortstondige vertalersessies voor een bepaald bron-/doeltaalpaar maakt en vertaalde strings asynchroon retourneert.

De bijbehorende Language Detector API (window.LanguageDetector) inspecteert een string en retourneert een gerangschikte lijst met waarschijnlijke BCP-47-taaltags en betrouwbaarheidsscores. Samen stellen de twee API's een pagina in staat de taal van willekeurige invoer te detecteren en deze vervolgens zonder netwerkverkeer te vertalen na de initiële modeldownload.

Omdat het model op het apparaat van de gebruiker wordt uitgevoerd, werken vertalingen offline nadat ze zijn gedownload, verlaat gevoelige tekst nooit de machine, en zijn er geen kosten per aanvraag voor de API. Het compromis is dat de beschikbaarheid afhangt van de browser, het besturingssysteem en of het aangevraagde taalpaar is gedownload.

Gereedschapbeschrijving

Deze playground is een interactieve omgeving voor het testen van de Translator en Language Detector API's in uw eigen browser. Het verbindt een invoergebied, een doeltaalkiezer en een uitvoergebied met de onderliggende Translator.create() / translate() aanroepen en toont de beschikbaarheidsstatus en downloadvoortgang van het model terwijl u experimenteert.

De brontaal staat standaard ingesteld op "Automatisch detecteren", wat de invoer eerst door LanguageDetector stuurt en vervolgens de gedetecteerde taal naar de vertaler doorstuurt. U kunt de brontaal ook expliciet vastpinnen om detectie over te slaan.

Voorbeelden

Functies

• Automatische taaldetectie — gebruikt de Language Detector API om de brontaal te identificeren voordat deze wordt vertaald.
• Bidirectionele taalkiezer — wissel bron en doel met één klik en vertaal opnieuw.
• Live beschikbaarheidsstatus — toont of het aangevraagde model available, downloadable, downloading of unavailable is.
• Downloadvoortgangsbalk — streamt downloadprogress events van de vertaler/detector terwijl het model wordt opgehaald.
• On-device, offline vertaling — nadat het model is gedownload, worden geen netwerkverzoeken gedaan om te vertalen.

Gebruiksscenario's

• Gelokaliseerde kopie bekijken — plak een string en zie direct hoe deze in een andere taal leest terwijl u UI-tekst opstelt.
• Browserondersteuning verifiëren — controleer of een specifiek bron-/doelpaar beschikbaar is voordat u een functie implementeert die afhankelijk is van de Translator API.
• Snelle offline vertaling — vertaal fragmenten zonder verbinding, nadat het relevante taalpakket is gedownload.

Vereisten

• Een browser die de Translator en Language Detector API's implementeert. Op het moment van schrijven zijn dit Chrome 138+ en op Chromium gebaseerde browsers (bijv. Opera 122+) op desktop. Edge, Firefox en Safari worden nog niet ondersteund.
• Een beveiligde context (HTTPS of localhost).
• Transient user activation — de API's staan create() alleen toe na een recent gebruikersgebaar, daarom wordt vertaling uitgevoerd bij invoer in plaats van bij het laden van de pagina.
• Voldoende schijfruimte en bandbreedte voor de initiële download van het taalmodel. Volgende vertalingen gebruiken het gecachte model opnieuw.

Hoe het werkt

1. Bij het laden controleert het gereedschap op window.Translator en window.LanguageDetector. Als een van beide ontbreekt, wordt een waarschuwing weergegeven en wordt de invoer uitgeschakeld.
2. Wanneer u typt, wordt de invoer vertraagd en wordt het bron-/doelpaar opgelost (eerst LanguageDetector.detect() uitvoeren als de bron auto is).
3. Translator.availability({ sourceLanguage, targetLanguage }) wordt aangeroepen om de modelstatus voor dat paar op te vragen.
4. Translator.create() wordt aangeroepen met een monitor callback die luistert naar downloadprogress events en de voortgangsbalk bijwerkt.
5. translator.translate(text) retourneert de vertaalde string, die in het uitvoergebied wordt weergegeven.
6. De vertaler- en detectorinstanties worden na elke aanroep via destroy() vrijgegeven om resources vrij te maken.

Ondersteunde talen

De kiezer toont een samengestelde lijst met veelgebruikte BCP-47-taaltags die het gebundelde model van Chrome ondersteunt of gewoonlijk test, inclusief:

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.

De werkelijke set bruikbare paren hangt af van wat het onderliggende browsermodel heeft gedownload of kan downloaden. Paren die als unavailable worden gerapporteerd, kunnen niet in uw huidige browser worden vertaald.

Beperkingen

• De API's zijn experimenteel en het oppervlak kan tussen browserversies veranderen.
• Vertaalkwaliteit wordt bepaald door het door de browser geleverde model en is niet gegarandeerd gelijk aan speciale cloudvertaaldiensten.
• Sommige taalparen kunnen een tussenliggende pivot via Engels vereisen of kunnen eenvoudig niet beschikbaar zijn.
• De eerste vertaling voor een nieuw taalpaar kan traag zijn vanwege de modeldownload.
• De API's worden momenteel niet blootgesteld aan webworkers en kunnen achter een Permissions Policy (translator, language-detector) op cross-origin iframes worden gated.

Veelgestelde vragen

Waarom blijft de uitvoer leeg? De Translator API is waarschijnlijk niet geïmplementeerd in uw browser. Open de pagina in Chrome 138+ op desktop en laad opnieuw.

Waarom wordt "Model downloaden…" weergegeven? De eerste keer dat u een taalpaar gebruikt, downloadt de browser een modelpakket. De voortgangsbalk geeft de downloadprogress events weer die door Translator.create() worden verzonden.

Verlaat mijn tekst het apparaat? Nee. Nadat het model is gedownload, vindt vertaling volledig on-device plaats. Het gereedschap zelf stuurt uw invoer nergens heen.

Waarom mislukt "Automatisch detecteren" soms? Als de invoer te kort, dubbelzinnig of in een script is dat de detector niet heeft gezien, kan LanguageDetector.detect() und (onbepaald) retourneren. Kies in dat geval handmatig de brontaal.