Azure Text Translation SDK

Artikel
10/02/2024

Die Azure-Textübersetzung ist ein cloudbasiertes REST-API-Feature des Azure KI Übersetzer-Diensts. Die Text Translation-API ermöglicht schnelle und genaue Textübersetzungen in Echtzeit. Das Text Translation Software Development Kit (SDK) ist eine Reihe von Bibliotheken und Tools, mit denen Sie die Funktionen der Text Translation-REST-API einfach in Ihre Anwendungen integrieren können. Das Text Translation-SDK ist auf allen Programmierplattformen in C#/.NET, Java, JavaScript und Python verfügbar.

Unterstützte Sprachen

Das Textübersetzungs-SDK unterstützt die folgenden Programmiersprachen und Plattformen:

Sprache → SDK-Version	Paket	Clientbibliothek	Unterstützte API-Version
.NET/C# → 1.0.0	NuGet	Azure SDK für .NET	Translator v3.0
Java✱ → 1.0.0	Maven-Repository	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

✱ Das Azure-Textübersetzungs-SDK für Java wurde getestet und wird unter Windows-, Linux- und macOS-Plattformen unterstützt. Es wurde nicht auf anderen Plattformen getestet, und es unterstützt keine Android-Bereitstellungen.

Änderungsprotokoll und Releaseverlauf

Dieser Abschnitt enthält eine versionsbasierte Beschreibung der Releases, Änderungen, Aktualisierungen und Erweiterungen der Features und Funktionen von Text Translation.

Übersetzertext SDK Mai 2024 GA-Version

Diese Version enthält die folgenden Updates:

Textübersetzungs-SDK – Vorschauversion vom April 2023

Diese Version enthält die folgenden Updates:

Verwenden des Text Translation-SDK in Ihren Anwendungen

Das Text Translation-SDK ermöglicht die Verwendung und Verwaltung des Text Translation-Diensts in Ihrer Anwendung. Das SDK basiert auf der zugrunde liegenden Text Translation-REST-API, mit der Sie diese APIs einfach in Ihrem Programmiersprachenparadigma verwenden können. So verwenden Sie das Text Translation-SDK für Ihre bevorzugte Programmiersprache:

1. Installieren der SDK-Clientbibliothek

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. Importieren der SDK-Clientbibliothek in Ihre Anwendung

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 TextTranslationClient
from azure-ai-translation-text import TextTranslationClient

3. Authentifizieren des Clients

Wenn Sie mit dem Übersetzerdienst über die Clientbibliothek interagieren, müssen Sie zunächst eine Instanz der Klasse „TextTranslationClient“ erstellen. Sie benötigen Ihren API-Schlüssel und Ihre Region, um ein Clientobjekt zu instanziieren. Der Text Translation-API-Schlüssel befindet sich im Azure-Portal:

Screenshot: Schlüssel und Endpunkt im Azure-Portal

Verwenden des globalen Endpunkts (Standard)

string key = "<your-key>";

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

Verwenden eines regionalen Endpunkts


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

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

Verwenden des globalen Endpunkts (Standard)


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

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

Verwenden eines regionalen Endpunkts

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. Erstellen Ihrer Anwendung

Erstellen Sie ein Clientobjekt, um mit dem Text Translation-SDK zu interagieren. Rufen Sie dann Methoden auf diesem Clientobjekt auf, um mit dem Dienst zu kommunizieren. Die SDKs bieten sowohl synchrone als auch asynchrone Methoden. Weitere Informationen finden Sie im Text Translation-Beispielrepository für .NET/C#.

Hilfeoptionen

In den Foren Microsoft F&A und Stack Overflow können Entwickler Fragen zur Azure Text Translation und zu anderen Diensten stellen und beantworten. Microsoft verfolgt die Foren und antwortet auf Fragen, die von der Community noch beantwortet werden müssen. Markieren Sie Ihre Frage mit azure-text-translation, um sicherzustellen, dass wir Ihre Frage sehen.

Nächste Schritte

Text Translation-Schnellstart

Referenzhandbuch zu Text Translation v3.0

Freigeben über