Azure TextTranslation REST client library for JavaScript - versie 2.0.0-beta.1

Azure-tekstvertaling is een cloudgebaseerde REST API die wordt geleverd door de Azure Translator-service. Het maakt gebruik van neurale machinevertalingstechnologie om precieze, contextueel relevante en semantisch nauwkeurige realtime tekstvertalingen te leveren in alle ondersteunde talen.

De clientbibliotheek biedt verschillende belangrijke functionaliteiten:

  • Haal de lijst op van talen die worden ondersteund voor vertaal- en transliteratieoperaties, evenals LLM-modellen die beschikbaar zijn voor vertalingen.

  • Voer deterministische tekstvertaling uit van een gespecificeerde brontaal naar een doeltaal, met configureerbare parameters om precisie te waarborgen en contextuele integriteit te behouden.

  • Voer transliteratie uit door tekst van het originele script om te zetten naar een alternatieve scriptrepresentatie.

  • Gebruik LLM-modellen om vertaalvarianten te produceren die toonspecifiek en genderbewust zijn.

Vertrouw sterk op onze REST-clientdocumenten om deze bibliotheek te gebruiken

Belangrijke schakels:

Aan de slag

Momenteel ondersteunde omgevingen

  • LTS-versies van Node.js
  • Nieuwste versies van Edge, Chrome, Safar en Firefox

Vereiste voorwaarden

  • Een bestaande vertaaldienst of cognitieve dienstenbron.

Het @azure-rest/ai-translation-text-pakket installeren

Installeer de Azure Text Translation REST-clientbibliotheek voor JavaScript met npm:

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

Maak een vertalerservicebron aan

Je kunt een vertaalbron aanmaken door een vertaler te creëren.

Browserondersteuning

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze bundeldocumentatie voor meer informatie over hoe u dit doet.

De client verifiëren

De interactie met de service via de clientbibliotheek begint met het aanmaken van een instantie van de TextTranslationClient-klasse . Je hebt een API-sleutel nodig of TokenCredential om een clientobject te instantiëren. Voor meer informatie over authenticatie met cognitieve diensten, zie Authenticate requests to Translator Service.

Een API-sleutel opvragen

Je kunt de endpoint, API key en Region van de Cognitive Services-bron of Translator-service-resourceinformatie in het Azure Portal krijgen.

Alternatief kun je het onderstaande Azure CLI-fragment gebruiken om de API-sleutel van de Translator-serviceresource te halen.

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

Maak een TextTranslationClient aan met een API-sleutel en een regio-credential

Zodra je de waarde voor de API-sleutel en regio hebt, maak je een TranslatorCredential.

Met de waarde van de TranslatorCredential kunt u de TextTranslationClient aanmaken:

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);

Voorbeelden

De volgende sectie bevat verschillende codefragmenten met behulp van het clientbovenstaande en behandelt de belangrijkste functies die aanwezig zijn in deze clientbibliotheek.

Ondersteunde talen ophalen

Hiermee haalt u de set talen op die momenteel worden ondersteund door andere bewerkingen van 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);
  }
}

Raadpleeg de servicedocumentatie voor een conceptuele bespreking van talen.

Translate

Hiermee wordt tekst in één brontaal weergegeven in meerdere doeltaalteksten met één aanvraag.

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}'.`,
  );
}

Raadpleeg de servicedocumentatie voor een conceptuele bespreking van vertalen.

Transliterate

Converteert tekens of letters van een brontaal naar de bijbehorende tekens of letters van een doeltaal.

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}'.`,
  );
}

Raadpleeg de dienstdocumentatie voor een conceptuele bespreking van transliteraat.

Probleemoplossingsproces

Wanneer je met de Translator Service interactie hebt via de TextTranslator-clientbibliotheek, komen fouten die door de Translator-service worden geretourneerd overeen met dezelfde HTTP-statuscodes die worden teruggegeven voor REST API-verzoeken.

Als je bijvoorbeeld een vertaalverzoek indient zonder een doelvertalingstaal, wordt er een 400 foutmelding teruggegeven die "Bad Request" aangeeft.

Loggen

Het inschakelen van logboekregistratie kan helpen nuttige informatie over fouten te ontdekken. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de omgevingsvariabele AZURE_LOG_LEVEL in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door setLogLevel aan te roepen in de @azure/logger:

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

setLogLevel("info");

Voor gedetailleerdere instructies over het inschakelen van logboeken, kunt u de documentatie over het @azure/logger-pakket bekijken.

  • Last updated on