Azure TextTranslation bibliothèque client REST pour JavaScript - version 2.0.0-beta.1

La traduction de texte Azure est une API REST basée sur le cloud fournie par le service Azure Translator. Il utilise la technologie de traduction automatique neuronale pour fournir des traductions de texte en temps réel précises, contextuellement pertinentes et sémantiquement précises dans toutes les langues prises en charge.

La bibliothèque client offre plusieurs fonctionnalités clés :

  • Récupérez la liste des langues prises en charge pour les opérations de traduction et de translitttération, ainsi que les modèles LLM disponibles pour les traductions.

  • Effectuer une traduction déterministe du texte d’une langue source spécifiée vers une langue cible, avec des paramètres configurables pour garantir la précision et maintenir l’intégrité contextuelle.

  • Effectuer la translittération en convertissant le texte de l’écriture originale en une représentation alternative de l’écriture.

  • Utilisez des modèles LLM pour produire des variantes de traduction spécifiques au ton et sensibles au genre.

S’il vous plaît s’appuyer fortement sur nos documents clients REST pour utiliser cette bibliothèque

Liens clés :

Mise en route

Environnements actuellement pris en charge

  • Versions LTS de Node.js
  • Dernières versions d’Edge, Chrome, Safar et Firefox

Prerequisites

  • Un service de traduction existant ou une ressource de services cognitifs.

Installer le package @azure-rest/ai-translation-text

Installez la bibliothèque client REST Azure Text Translation pour JavaScript avec npm:

npm install @azure-rest/ai-translation-text

Créer une ressource de service traducteur

Vous pouvez créer une ressource traductrice après créer une ressource traductrice.

Support des navigateurs

Offre groupée JavaScript

Pour utiliser cette bibliothèque cliente dans le navigateur, vous devez d’abord utiliser un bundler. Pour plus d’informations sur la procédure à suivre, reportez-vous à notre documentation de regroupement .

Authentifier le client

L’interaction avec le service via la bibliothèque client commence par la création d’une instance de la classe TextTranslationClient . Vous aurez besoin d’une clé API ou TokenCredential d’instancier un objet client. Pour plus d’informations concernant l’authentification avec des services cognitifs, voir Authentifier les requêtes vers le service de traducteur.

Obtenir une clé API

Vous pouvez obtenir le endpoint, API key et Region depuis les informations sur la ressource des services cognitifs ou le service traducteur dans le portail Azure.

Sinon, utilisez l’extrait Azure CLI ci-dessous pour obtenir la clé API depuis la ressource du service Traducteur.

az cognitiveservices account keys list --resource-group <your-resource-group-name> --name <your-resource-name>

Créer une TextTranslationClient clé API et une identifiante régionale

Une fois que vous avez la valeur de la clé API et de la Région, créez un TranslatorCredentialfichier .

Avec la valeur de , TranslatorCredential vous pouvez créer le TextTranslationClient :

import TextTranslationClient, { TranslatorCredential } from "@azure-rest/ai-translation-text";

const endpoint = "https://api.cognitive.microsofttranslator.com";
const key = "YOUR_SUBSCRIPTION_KEY";
const region = "westus";
const credential: TranslatorCredential = {
  key,
  region,
};
const translationClient = TextTranslationClient(endpoint, credential);

Examples

La section suivante fournit plusieurs extraits de code à partir de ce clientqui précède, et couvre les principales fonctionnalités présentes dans cette bibliothèque cliente.

Obtenir les langues prises en charge

Obtient l’ensemble de langues actuellement prises en charge par d’autres opérations de Translator.

import TextTranslationClient, {
  TranslatorCredential,
  isUnexpected,
} from "@azure-rest/ai-translation-text";

const endpoint = "https://api.cognitive.microsofttranslator.com";
const key = "YOUR_SUBSCRIPTION_KEY";
const region = "westus";
const credential: TranslatorCredential = {
  key,
  region,
};
const translationClient = TextTranslationClient(endpoint, credential);

const langResponse = await translationClient.path("/languages").get();

if (isUnexpected(langResponse)) {
  throw langResponse.body.error;
}

const languages = langResponse.body;

if (languages.translation) {
  console.log("Translated languages:");
  for (const [key, translationLanguage] of Object.entries(languages.translation)) {
    console.log(`${key} -- name: ${translationLanguage.name} (${translationLanguage.nativeName})`);
  }
}

if (languages.transliteration) {
  console.log("Transliteration languages:");
  for (const [key, transliterationLanguage] of Object.entries(languages.transliteration)) {
    console.log(
      `${key} -- name: ${transliterationLanguage.name} (${transliterationLanguage.nativeName})`,
    );
  }
}

if (languages.models) {
  console.log("Available LLM Models:");
  for (const model in languages.models) {
    console.log(model);
  }
}

Veuillez consulter la documentation du service pour une discussion conceptuelle des langues.

Traduire

Restitue un texte en langage source unique dans plusieurs textes de langue cible avec une seule requête.

import TextTranslationClient, {
  TranslatorCredential,
  isUnexpected,
} from "@azure-rest/ai-translation-text";

const endpoint = "https://api.cognitive.microsofttranslator.com";
const key = "YOUR_SUBSCRIPTION_KEY";
const region = "westus";
const credential: TranslatorCredential = {
  key,
  region,
};
const translationClient = TextTranslationClient(endpoint, credential);

const input = {
  text: "This is a test.",
  targets: [{ language: "cs" }],
  language: "en",
};
const translateResponse = await translationClient.path("/translate").post({
  body: { inputs: [input] },
});

if (isUnexpected(translateResponse)) {
  throw translateResponse.body.error;
}

const translations = translateResponse.body.value;
for (const translation of translations) {
  console.log(
    `Text was translated to: '${translation?.translations[0]?.language}' and the result is: '${translation?.translations[0]?.text}'.`,
  );
}

Veuillez consulter la documentation du service pour une discussion conceptuelle sur Translate.

Translittérer

Convertit des caractères ou des lettres d’une langue source en caractères ou lettres correspondants d’une langue cible.

import TextTranslationClient, {
  TranslatorCredential,
  isUnexpected,
} from "@azure-rest/ai-translation-text";

const endpoint = "https://api.cognitive.microsofttranslator.com";
const key = "YOUR_SUBSCRIPTION_KEY";
const region = "westus";
const credential: TranslatorCredential = {
  key,
  region,
};
const translationClient = TextTranslationClient(endpoint, credential);

const inputText = [{ text: "这是个测试。" }];
const parameters = {
  language: "zh-Hans",
  fromScript: "Hans",
  toScript: "Latn",
};
const transliterateResponse = await translationClient.path("/transliterate").post({
  body: { inputs: inputText },
  queryParameters: parameters,
});

if (isUnexpected(transliterateResponse)) {
  throw transliterateResponse.body.error;
}

const transliterations = transliterateResponse.body.value;
for (const transliteration of transliterations) {
  console.log(
    `Input text was transliterated to '${transliteration?.script}' script. Transliterated text: '${transliteration?.text}'.`,
  );
}

Veuillez consulter la documentation du service pour une discussion conceptuelle sur la translittération.

Résolution des problèmes

Lorsque vous interagissez avec le service Traducteur en utilisant la bibliothèque client TextTranslator, les erreurs retournées par le service Traducteur correspondent aux mêmes codes d’état HTTP que pour les requêtes API REST.

Par exemple, si vous soumettez une requête de traduction sans langue cible, une 400 erreur est renvoyée, indiquant « Mauvaise requête ».

Logging

L’activation de la journalisation peut vous aider à découvrir des informations utiles sur les échecs. Pour afficher un journal des requêtes et réponses HTTP, définissez la variable d’environnement AZURE_LOG_LEVEL sur info. Vous pouvez également activer la journalisation au moment de l’exécution en appelant setLogLevel dans la @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Pour obtenir des instructions plus détaillées sur l’activation des journaux, vous pouvez consulter la documentationdu package @azure/enregistreur d’événements.

  • Last updated on