Azure Text Translation SDK

Artikel
09/27/2024

Azure Text Translation är en molnbaserad REST API-funktion i Azure AI Translator-tjänsten. API:et för textöversättning möjliggör snabba och korrekta textöversättningar från källa till mål i realtid. SDK (Software Development Kit) för textöversättning är en uppsättning bibliotek och verktyg som gör att du enkelt kan integrera REST API-funktioner för textöversättning i dina program. SDK för textöversättning är tillgängligt på olika programmeringsplattformar i C#/.NET, Java, JavaScript och Python.

Språk som stöds

SDK för textöversättning stöder programmeringsspråk och plattformar:

Language → SDK-version	Paket	Klientbibliotek	API-version som stöds
.NET/C# → 1.0.0	NuGet	Azure SDK för .NET	Translator v3.0
Java✱ → 1.0.0	Maven-lagringsplats	Azure SDK för Java	Translator v3.0
JavaScript → 1.0.0	npm	Azure SDK för JavaScript	Translator v3.0
Python → 1.0.1	PyPi	Azure SDK för Python	Translator v3.0

✱ Azure Text Translation SDK för Java testas och stöds på Windows-, Linux- och macOS-plattformar. Den testas inte på andra plattformar och stöder inte Android-distributioner.

Ändringslogg och versionshistorik

Det här avsnittet innehåller en versionsbaserad beskrivning av funktionsversioner av textöversättning, ändringar, uppdateringar och förbättringar.

Translator Text SDK maj 2024 GA-version

Den här versionen innehåller följande uppdateringar:

Förhandsversionen av Translator Text SDK april 2023

Den här versionen innehåller följande uppdateringar:

Använda SDK för textöversättning i dina program

Med SDK för textöversättning kan du använda och hantera textöversättningstjänsten i ditt program. SDK bygger på det underliggande REST API:et för textöversättning så att du enkelt kan använda dessa API:er i ditt programmeringsspråkparadigm. Så här använder du SDK för textöversättning för önskat programmeringsspråk:

1. Installera SDK-klientbiblioteket

dotnet add package Azure.AI.Translation.Text --version 1.0.0-beta.1

Install-Package Azure.AI.Translation.Text -Version 1.0.0-beta.1

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-translation-text</artifactId>
    <version>1.0.0-beta.1</version>
</dependency>

implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")

npm i @azure-rest/ai-translation-text@1.0.0-beta.1

pip install azure-ai-translation-text==1.0.0b1

2. Importera SDK-klientbiblioteket till ditt program

using Azure;
using Azure.AI.Translation.Text;

import java.util.List;
import java.util.ArrayList;
import com.azure.ai.translation.text.models.*;
import com.azure.ai.translation.text.TextTranslationClientBuilder;
import com.azure.ai.translation.text.TextTranslationClient;

import com.azure.core.credential.AzureKeyCredential;

const {TextTranslationClient } = require("@azure-rest/ai-translation-text").default;

from azure.core.credentials import AzureKeyCredential
from azure.ai.translation.text import TextTranslationClient

3. Autentisera klienten

Interaktion med Translator-tjänsten med hjälp av klientbiblioteket börjar med att skapa en instans av TextTranslationClientklassen. Du behöver din API-nyckel och region för att instansiera ett klientobjekt. Api-nyckeln för textöversättning finns i Azure Portal:

Skärmbild av nycklar och slutpunktsplats i Azure Portal.

Använda den globala slutpunkten (standard)

string key = "<your-key>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);

Använda en regional slutpunkt


Uri endpoint = new("<your-endpoint>");
string key = "<your-key>";
string region = "<region>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential, region);

Använda den globala slutpunkten (standard)


String apiKey = "<your-key>";
AzureKeyCredential credential = new AzureKeyCredential(apiKey);

TextTranslationClient client = new TextTranslationClientBuilder()
            .credential(credential)
            .buildClient();

Använda en regional slutpunkt

String apiKey = "<your-key>";
String endpoint = "<your-endpoint>";
String region = "<region>";

AzureKeyCredential credential = new AzureKeyCredential(apiKey);

TextTranslationClient client = new TextTranslationClientBuilder()
.credential(credential)
.region(region)
.endpoint(endpoint)
.buildClient();


const TextTranslationClient = require("@azure-rest/ai-translation-text").default,

const apiKey = "<your-key>";
const endpoint = "<your-endpoint>";
const region = "<region>";


from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
from azure.ai.translation.text.models import InputTextItem
from azure.core.exceptions import HttpResponseError

key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"


credential = TranslatorCredential(key, region)
text_translator = TextTranslationClient(endpoint=endpoint, credential=credential)

4. Skapa ditt program

Skapa ett klientobjekt för att interagera med SDK:et för textöversättning och anropa sedan metoder på klientobjektet för att interagera med tjänsten. SDK:erna innehåller både synkrona och asynkrona metoder. Mer information finns i exempellagringsplatsen för textöversättning för .NET/C#.

Hjälpalternativ

Microsoft Q &A- och Stack Overflow-forumen är tillgängliga för utvecklarcommunityn för att ställa och svara på frågor om Azure TextÖversättning och andra tjänster. Microsoft övervakar forumen och svarar på frågor som communityn ännu inte har besvarat. Se till att du ser din fråga genom att tagga den med azure-text-translation.

Nästa steg

Snabbstart för textöversättning

Referensguide för textöversättning v3.0

Dela via