Traducir texto con la API de Translator

Usa la API de Translator para traducir texto entre diferentes idiomas desde código JavaScript en tu sitio web o extensión del navegador. La API de Translator se basa en un modelo de tarea específica integrado en Microsoft Edge.

Contenido detallado:

Introducción

Para obtener información introductoria sobre la API de Translator, consulte:

Uso de la API de detección de idioma con la API de traductor

Para facilitar la traducción de texto proporcionado por el usuario a otro idioma, use la API Translator junto con la API Language Detector.

Para obtener información sobre la API de Language Detector, consulte Detectar idiomas con la API de Language Detector.

Ventajas de la API de Translator

La API de Translator usa un modelo específico de tarea para la traducción automática que se ejecuta en el mismo dispositivo donde se usan las entradas y salidas del modelo (es decir, localmente). Este enfoque tiene las siguientes ventajas en comparación con las soluciones basadas en la nube:

  • Costo reducido: El uso de un servicio de traducción en la nube no tiene ningún costo.

  • Independencia de la red: Más allá de la descarga inicial del modelo, no hay latencia de red al usar esta API para traducir texto y la API también se puede usar cuando el dispositivo está sin conexión.

  • Privacidad mejorada: La entrada de datos en el modelo nunca abandona el dispositivo y no se recopila para entrenar modelos de inteligencia artificial.

Los modelos de traducción para pares de idiomas especificados se descargan la primera vez que se usa la API en Microsoft Edge y, posteriormente, se comparten en todos los sitios web del explorador. Se accede a los modelos a través de una API web sencilla que no requiere conocimiento de marcos de terceros y no requiere experiencia en inteligencia artificial (IA) o aprendizaje automático (ML).

Alternativas a la API de Translator

Puede enviar solicitudes de red a servicios de traducción basados en la nube con capacidades más sofisticadas, incluida la traducción neuronal; consulte la documentación de Traductor de Azure AI.

Como alternativa en el dispositivo, la API de aviso también puede servir escenarios de solicitud más personalizados y multilingües, con un modelo de lenguaje pequeño que está integrado en Microsoft Edge; consulte Prompt a built-in language model with the Prompt API.

Aviso de declinación de responsabilidades

Al igual que otros modelos de traducción automática, los modelos específicos de tareas de Microsoft Edge pueden producir traducciones injustas, poco confiables u ofensivas. Para obtener más información sobre las limitaciones de estos modelos de traducción automática, consulte Limitaciones en la Nota de transparencia de Traductor de Azure AI.

Disponibilidad de modelos

Se requiere una descarga inicial del modelo de traducción en el dispositivo la primera vez que un sitio web llama a la API de Translator. Puede supervisar la descarga del modelo mediante la opción de supervisión al crear una nueva sesión de la API de Translator; consulte Supervisar el progreso de la descarga del modelo (monitor), a continuación.

Vea un ejemplo práctico

Para ver la API de Translator en acción y revisar el código existente que usa la API:

  1. Vaya al área de juegos de la API de Translator en una nueva ventana o pestaña.

  2. En el banner de información en la parte superior, verifique el estado: inicialmente dice: API en el dispositivo y modelo descargable. El modelo de un par de idiomas especificado se descargará la primera vez que se use la API.

  3. En el cuadro de texto para traducir , escriba el texto que desea traducir y, opcionalmente, cambie los valores de idioma de origen e idioma de destino .

  4. Haz clic en el botón Traducir .

    Si el modelo para el par de idiomas especificado no se ha descargado antes, se inicia la descarga.

    Indicador de estado que muestra el progreso de la descarga del modelo

    Si la descarga del modelo no comienza, reinicia Microsoft Edge y vuelve a intentarlo.

    Una vez descargado el modelo, el modelo comienza a generar una traducción del texto del idioma de origen al idioma de destino.

    El resultado se genera en la sección de respuestas de la página:

    La página de demostración de Translator con la configuración y un botón Traducir

  5. Para dejar de generar la respuesta, en cualquier momento, haga clic en el botón Detener .

Vea también:

  • /built-in-ai/ - Código fuente y archivo Léame de la demostración de áreas de juego de IA integrada.

Usar la API de Translator

Las siguientes secciones tratan sobre el uso de la API de Translator.

Compruebe si la API de Translator está habilitada

Antes de usar la API de Translator en el código de su sitio web, verifique que la API esté disponible probando la Translator presencia del objeto:

if (!Translator) {
  // The Translator API is not available.
} else {
  // The Translator API is available.
}

Compruebe si el modelo se puede utilizar (availability())

La API de Translator tiene los siguientes requisitos:

  • Debe admitirse la traducción del idioma de origen especificado al idioma de destino especificado.
  • Microsoft Edge ya debe haber descargado el modelo de traducción para el par de idiomas y el tiempo de ejecución del modelo.

Para comprobar si se puede usar la API de traductor, llame Translator.availability()a:

const availability = await Translator.availability({
  sourceLanguage: "en",
  targetLanguage: "es"
});

if (availability == "unavailable") {
  // The model is not available.
}

if (availability == "downloadable" || availability == "downloading") {
  // The model can be used, but it needs to be downloaded first.
}

if (availability == "available") {
  // The model is available and can be used.
}

Para sourceLanguage y targetLanguage, usa los códigos de idioma en Etiquetas para identificar idiomas, como cadenas.

Crear una nueva sesión (create())

Al crear una sesión, se indica al explorador que cargue el modelo de lenguaje en la memoria para que se pueda usar. Para poder traducir texto, cree una nueva sesión mediante el Translator.create() método y especifique los idiomas de origen y destino:

// Create a Translator session.
const session = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "es"
});

Puede supervisar la descarga del modelo mediante la monitor siguiente opción.

Supervisar el progreso de la descarga del modelo (monitor)

Puede seguir el progreso de la descarga del modelo mediante la monitor opción. Esto es útil cuando el modelo aún no se ha descargado completamente en el dispositivo en el que se utilizará el modelo, para informar a los usuarios de su sitio web que deben esperar.

// Use the monitor option to monitor the model download.
const session = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "es",
  monitor: m => {
    // Use the monitor object argument to add an listener for the
    // downloadprogress event.
    m.addEventListener("downloadprogress", event => {
      // The event is an object with the loaded and total properties.
      if (event.loaded == event.total) {
        // The model is fully downloaded.
      } else {
        // The model is still downloading.
        const percentageComplete = (event.loaded / event.total) * 100;
      }
    });
  }
});

Ejecutar la API de Translator

Después de crear una sesión de modelo, puede traducir texto. La API de traducción proporciona dos métodos para traducir texto:

  • session.translate() Devuelve una promesa, que se resuelve después de traducir el texto.
  • session.translateStreaming() Devuelve inmediatamente un objeto Stream, que puede usar para mostrar el texto traducido, token por token, a medida que se genera.

Los detalles están a continuación.

Esperar a que se traduzca el texto (translate())

Traduce texto. Devuelve una promesa, que se resuelve después de traducir el texto.

Para esperar a que el texto se traduzca completamente antes de continuar ejecutando el código, use el translate() método asincrónico. Este método devuelve una promesa que se resuelve después de que la API haya terminado de generar texto:

// Create a Translator session.
const translatorSession = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "es"
});

// Translate the text and wait for the translation to be done.
const translatedText = await translatorSession.translate(sourceText);

// Use the translation.
console.log(translatedText);

Mostrar tokens a medida que se generan (translateStreaming())

Traduce texto. Devuelve inmediatamente un objeto de flujo, que puede usar para mostrar el texto traducido, token por token, a medida que se genera.

Para mostrar los tokens a medida que se generan, use este método de streaming. El translateStreaming() método devuelve un objeto de secuencia inmediatamente. Use el objeto de secuencia devuelto para mostrar los tokens de respuesta a medida que se generan:

// Create a Translator session.
const translatorSession = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "es"
});

// Ask the model to translate text.
const stream = translatorSession.translateStreaming(sourceText);

// Use the stream object to display tokens that are generated by the model,
// as they are being generated.
for await (const token of stream) {
  console.log(token);
}

Detener la traducción de texto (abortController.signal)

Para detener la traducción de texto antes de que la promesa o la secuencia devuelta por los métodos anteriores se hayan resuelto o finalizado, use una AbortController señal:

// Create a Translator session.
const translatorSession = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "es"
});

// Create an AbortController object.
const abortController = new AbortController();

// Use the model session to translate some text and pass the AbortController
// object by using the signal option.
const stream = translatorSession.translateStreaming(sourceText, {
  signal: abortController.signal
});

// Later, perhaps when the user presses a "Stop" button, call the abort()
// method on the AbortController object to stop translating text.
abortController.abort();

Destruir una sesión (destroy())

Después de traducir el texto, destruya la sesión para que el explorador sepa que ya no necesita el modelo de lenguaje, de modo que el modelo se pueda descargar de la memoria.

Puedes destruir una sesión de dos maneras distintas:

  • Mediante el destroy() método.
  • Al usar un AbortControllercomando .

Los detalles están a continuación.

Destruir una sesión llamando a destroy()

Para destruir una sesión mediante una llamada destroy() con una Translator sesión:

const session = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "es"
});

// Later, destroy the session by using the destroy method.
session.destroy();

Para destruir una sesión, use AbortController

Para destruir una sesión mediante la creación de un AbortController objeto, cree una Translator sesión y, a continuación, llame abort()a :

// Create an AbortController object.
const controller = new AbortController();

// Create a Translator session and pass the
// AbortController object by using the signal option.
const session = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "es",
  signal: controller.signal
});

// Later, perhaps when the user interacts with the UI, destroy the session by
// calling the abort() function of the AbortController object.
controller.abort();

Enviar comentarios

Nos interesa obtener información sobre:

  • La gama de escenarios para los que usa la API de Translator.
  • Cualquier problema con la API de Translator.
  • Cualquier problema con los modelos de traducción en el dispositivo.
  • Si serían útiles otras API integradas específicas para tareas.

Para enviar comentarios sobre tus escenarios y las tareas que quieres realizar, agrega un comentario al problema de comentarios de la API de Translator.

Si observa algún problema al usar la API en su lugar, infórmelo en el repositorio.

También puede contribuir a la discusión sobre el diseño de la API Translator en el repositorio W3C Web Machine Learning Working Group.

Vea también

GitHub:

Documentos de Azure:

repositorio de demostraciones: