Azure Text Translation SDK

Článek
09/27/2024

Azure Text Translation je cloudová funkce rozhraní REST API služby Azure AI Translator. Rozhraní API pro překlad textu umožňuje rychlé a přesné překlady textu do cílového zdroje v reálném čase. Sada SDK (Text Translation Software Development Kit) je sada knihoven a nástrojů, které umožňují snadno integrovat funkce REST API překladu textu do vašich aplikací. Sada SDK pro překlad textu je k dispozici na různých programovacích platformách v jazyce C#/.NET, Java, JavaScript a Python.

Podporované jazyky

Sada SDK pro překlad textu podporuje programovací jazyky a platformy:

Verze sady Language → SDK	Balíček	Klientská knihovna	Podporovaná verze rozhraní API
.NET/C# → 1.0.0	NuGet	Azure SDK pro .NET	Translator v3.0
Java✱ → 1.0.0	Úložiště Maven	Azure SDK pro Javu	Translator v3.0
JavaScript → 1.0.0	npm	Azure SDK pro JavaScript	Translator v3.0
Python → 1.0.1	PyPi	Azure SDK pro Python	Translator v3.0

✱ Sada Azure Text Translation SDK pro Javu se testuje a podporuje na platformách Windows, Linux a macOS. Není testován na jiných platformách a nepodporuje nasazení Androidu.

Historie protokolu změn a vydaných verzí

Tato část obsahuje popis funkcí překladu textu a funkcí založených na verzích, změnách, aktualizacích a vylepšeních.

Verze ga pro Translator Text SDK z května 2024

Tato verze zahrnuje následující aktualizace:

Verze Translator Text SDK z dubna 2023 Preview

Tato verze zahrnuje následující aktualizace:

Použití sady SDK pro překlad textu v aplikacích

Sada SDK pro překlad textu umožňuje ve vaší aplikaci používat a spravovat službu Překlad textu. Sada SDK vychází ze základního rozhraní REST API pro překlad textu, které umožňuje snadno používat tato rozhraní API v rámci paradigmatu programovacího jazyka. Tady je postup použití sady SDK pro překlad textu pro preferovaný programovací jazyk:

1. Instalace klientské knihovny 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. Import klientské knihovny SDK do aplikace

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. Ověření klienta

Interakce se službou Translator pomocí klientské knihovny začíná vytvořením instance TextTranslationClienttřídy. K vytvoření instance objektu klienta potřebujete klíč rozhraní API a oblast. Klíč rozhraní API pro překlad textu najdete na webu Azure Portal:

Snímek obrazovky s klíči a umístěním koncového bodu na webu Azure Portal

Použití globálního koncového bodu (výchozí)

string key = "<your-key>";

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

Použití regionálního koncového bodu


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

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

Použití globálního koncového bodu (výchozí)


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

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

Použití regionálního koncového bodu

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. Sestavení aplikace

Vytvořte objekt klienta pro interakci se sadou Text Translation SDK a potom volejte metody na daném objektu klienta pro interakci se službou. Sady SDK poskytují synchronní i asynchronní metody. Další přehled najdete v ukázkovém úložišti překladu textu pro .NET/C#.

Možnosti nápovědy

Fóra Microsoft Q &a Stack Overflow jsou k dispozici pro komunitu vývojářů, kde se můžete ptát a odpovídat na otázky týkající se překladu textu Azure a dalších služeb. Microsoft monitoruje fóra a odpovídá na otázky, na které má komunita odpověď. Abychom měli jistotu, že vidíte vaši otázku, označte ji značkou azure-text-translation.

Další kroky

Rychlý start k překladu textu

Referenční příručka k překladu textu v3.0

Sdílet prostřednictvím