Azure Text translation SDK

2025-05-28

Azure Text Translation is een cloudgebaseerde REST API-functie van de Azure AI Translator-service. Met de Tekstomzettings-API kunt u in realtime snelle en nauwkeurige tekstvertalingen voor bron-naar-doelteksten uitvoeren. De Text Translation Software Development Kit (SDK) is een set bibliotheken en hulpprogramma's waarmee u de REST API-mogelijkheden voor tekstomzetting eenvoudig in uw toepassingen kunt integreren. De SDK voor tekstomzetting is beschikbaar op programmeerplatforms in C#/.NET, Java, JavaScript en Python.

Ondersteunde talen

De SDK voor tekstomzetting ondersteunt de programmeertalen en platforms:

Taal → SDK-versie	Pakket	Klantbibliotheek	Ondersteunde API-versie
.NET/C# → 1.0.0	NuGet	Azure-SDK voor .NET	Translator v3.0
Java✱ → 1.0.0	Maven-opslagplaats	Azure SDK voor Java	Translator v3.0
JavaScript → 1.0.0	npm	Azure SDK voor JavaScript	Translator v3.0
Python → 1.0.1	PyPi	Azure-SDK voor Python	Translator v3.0

✱ De Azure Text Translation SDK voor Java wordt getest en ondersteund op Windows-, Linux- en macOS-platforms. Het wordt niet getest op andere platforms en biedt geen ondersteuning voor Android-implementaties.

Changelog- en releasegeschiedenis

Deze sectie biedt een beschrijving op basis van versies van de functie voor tekstvertaling, inclusief de uitgaven, wijzigingen, updates en verbeteringen.

Release van Translator Text SDK van mei 2024 (GA)

Deze release bevat de volgende updates:

Versie 1.0.0 (2024-05-21)
Doelstellingen voor tekstvertaling v3.0
GA-versie vrijgave

Pakket (NuGet)

Wijzigingslogboek en releasegeschiedenis

LEESMIJ

Voorbeelden

Preview-versie van Translator Text SDK van april 2023

Deze release bevat de volgende updates:

Versie 1.0.0-beta.1 (2023-04-17)
Doelen voor tekstomzetting v3.0
Eerste versierelease

Pakket (NuGet)

Wijzigingslogboek en releasegeschiedenis

LEESMIJ

Voorbeelden

Tekstomzettings-SDK gebruiken in uw toepassingen

De Text Translation SDK maakt het gebruik en beheer van de Text Translation-service in uw toepassing mogelijk. De SDK bouwt voort op de onderliggende REST API voor tekstomzetting, zodat u deze API's eenvoudig kunt gebruiken binnen uw programmeertaalparadigma. U gebruikt als volgt de Text Translation SDK voor de programmeertaal van uw voorkeur:

1. Installeer de SDK-clientbibliotheek

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. Importeer de SDK-clientbibliotheek in uw toepassing

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. De client verifiëren

Interactie met de Translator-service met behulp van de clientbibliotheek begint met het maken van een exemplaar van de TextTranslationClientklasse. U hebt uw API-sleutel en -regio nodig om een clientobject te instantiëren. De API-sleutel voor tekstomzetting vindt u in Azure Portal:

Schermopname van de sleutels en eindpuntlocatie in Azure Portal.

Het globale eindpunt gebruiken (standaard)

string key = "<your-key>";

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

Een regionaal eindpunt gebruiken


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

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

Het globale eindpunt gebruiken (standaard)


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

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

Een regionaal eindpunt gebruiken

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. Uw toepassing bouwen

Maak een clientobject om te communiceren met de Text Translation SDK en roep vervolgens methoden aan voor dat clientobject om met de service te communiceren. De SDK's bieden zowel synchrone als asynchrone methoden. Zie de voorbeeldopslagplaats tekstvertaling voor .NET/C# voor meer inzicht.

Helpopties

De Microsoft Q & A- en Stack Overflow-forums zijn beschikbaar voor de ontwikkelaarscommunity om vragen te stellen en te beantwoorden over Azure Text-vertaling en andere services. Microsoft bewaakt de forums en beantwoordt vragen die de community nog moet beantwoorden. Om er zeker van te zijn dat we uw vraag zien, tagt u deze met azure-text-translation.

Volgende stappen

Snelstartgids voor tekstomzetting

Naslaghandleiding voor tekstomzetting v3.0