Azure Text Translation SDK

Artikel
09/27/2024

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

Ondersteunde talen

Text Translation SDK ondersteunt de programmeertalen en platforms:

Taal → SDK-versie	Pakket	Clientbibliotheek	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 bevat een beschrijving op basis van een versie van de functie Tekstomzetting en functiereleases, wijzigingen, updates en verbeteringen.

Ga-release van Translator Text SDK van mei 2024

Deze release bevat de volgende updates:

Preview-versie van Translator Text SDK van april 2023

Deze release bevat de volgende updates:

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 de Text Translation SDK als volgt 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 tekstomzetting voor .NET/C# voor meer inzicht.

Help-opties

De Microsoft Q & A - en Stack Overflow-forums zijn beschikbaar voor de ontwikkelaarscommunity om vragen te stellen en te beantwoorden over Azure Text Translation 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

Naslaggids voor tekstomzetting v3.0

Delen via