Zestaw SDK tłumaczenia tekstu platformy Azure

Artykuł
09/27/2024

Tłumaczenie tekstu platformy Azure to oparta na chmurze funkcja interfejsu API REST usługi Azure AI Translator. Interfejs API tłumaczenia tekstu umożliwia szybkie i dokładne tłumaczenia tekstu źródłowego do docelowego w czasie rzeczywistym. Zestaw SDK (Text Translation Software Development Kit) to zestaw bibliotek i narzędzi, które umożliwiają łatwą integrację funkcji interfejsu API REST tłumaczenia tekstu z aplikacjami. Zestaw SDK tłumaczenia tekstu jest dostępny na różnych platformach programowania w języku C#/.NET, Java, JavaScript i Python.

Obsługiwane języki

Zestaw SDK tłumaczenia tekstu obsługuje języki programowania i platformy:

Wersja zestawu SDK → języka	Pakiet	Biblioteka kliencka	Obsługiwana wersja interfejsu API
.NET/C# → 1.0.0	NuGet	Zestaw Azure SDK dla platformy .NET	Translator w wersji 3.0
Java✱ → 1.0.0	Repozytorium Maven	Zestaw Azure SDK dla języka Java	Translator w wersji 3.0
JavaScript → 1.0.0	npm	Zestaw Azure SDK dla języka JavaScript	Translator w wersji 3.0
Python → 1.0.1	PyPi	Zestaw Azure SDK dla środowiska Python	Translator w wersji 3.0

✱ Zestaw SDK tłumaczenia tekstu platformy Azure dla języka Java jest testowany i obsługiwany na platformach Windows, Linux i macOS. Nie jest testowany na innych platformach i nie obsługuje wdrożeń systemu Android.

Dziennik zmian i historia wersji

Ta sekcja zawiera opis oparty na wersji funkcji tłumaczenia tekstu i wydań funkcji, zmian, aktualizacji i ulepszeń.

Wersja ogólnodostępna zestawu SDK tłumaczenia tekstu w usłudze Translator z maja 2024 r.

Ta wersja zawiera następujące aktualizacje:

Wersja zapoznawcza zestawu SDK tłumaczenia tekstu w usłudze Translator z kwietnia 2023 r.

Ta wersja zawiera następujące aktualizacje:

Korzystanie z zestawu SDK tłumaczenia tekstu w aplikacjach

Zestaw SDK tłumaczenia tekstu umożliwia korzystanie z usługi tłumaczenia tekstu i zarządzanie nią w aplikacji. Zestaw SDK opiera się na podstawowym interfejsie API REST tłumaczenia tekstu, który umożliwia łatwe korzystanie z tych interfejsów API w ramach paradygmatu języka programowania. Oto jak używasz zestawu SDK tłumaczenia tekstu dla preferowanego języka programowania:

1. Instalowanie biblioteki klienta zestawu SDK

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. Importowanie biblioteki klienta zestawu SDK do aplikacji

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. Uwierzytelnianie klienta

Interakcja z usługą Translator przy użyciu biblioteki klienta rozpoczyna się od utworzenia wystąpienia TextTranslationClientklasy. Klucz interfejsu API i region są potrzebne do utworzenia wystąpienia obiektu klienta. Klucz interfejsu API tłumaczenia tekstu znajduje się w witrynie Azure Portal:

Zrzut ekranu przedstawiający klucze i lokalizację punktu końcowego w witrynie Azure Portal.

Używanie globalnego punktu końcowego (ustawienie domyślne)

string key = "<your-key>";

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

Korzystanie z regionalnego punktu końcowego


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

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

Używanie globalnego punktu końcowego (ustawienie domyślne)


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

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

Korzystanie z regionalnego punktu końcowego

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. Kompilowanie aplikacji

Utwórz obiekt klienta w celu interakcji z zestawem SDK tłumaczenia tekstu, a następnie wywołaj metody dla tego obiektu klienta w celu interakcji z usługą. Zestawy SDK zapewniają metody synchroniczne i asynchroniczne. Aby uzyskać więcej szczegółowych informacji, zobacz repozytorium przykładu tłumaczenia tekstu dla platformy .NET/C#.

Opcje pomocy

Fora Microsoft Q & A i Stack Overflow są dostępne dla społeczności deweloperów, aby zadawać i odpowiadać na pytania dotyczące tłumaczenia tekstu platformy Azure i innych usług. Firma Microsoft monitoruje fora i odpowiada na pytania, na które społeczność nie odpowiedziała. Aby upewnić się, że widzisz pytanie, oznacz je tagiem azure-text-translation.

Następne kroki

Tłumaczenie tekstu — szybki start

Podręcznik referencyjny tłumaczenia tekstu w wersji 3.0

Udostępnij za pośrednictwem