Azure Text Translation SDK (Preview)

Článek
01/10/2024

Důležité

Sady SDK pro text služby Translator jsou aktuálně dostupné ve verzi Public Preview. Funkce, přístupy a procesy se můžou před obecnou dostupností (GA) změnit na základě zpětné vazby uživatelů.

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-beta.1	NuGet	Azure SDK pro .NET	Translator v3.0
Java✱ → 1.0.0-beta.1	Úložiště MVN	Azure SDK pro Javu	Translator v3.0
JavaScript → 1.0.0-beta.1	npm	Azure SDK pro JavaScript	Translator v3.0
Python → 1.0.0b1	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 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:

Screenshot of the keys and endpoint location in the 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 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