Azure Text Translation SDK

Cikk
09/27/2024

Az Azure Text Translation az Azure AI Translator szolgáltatás felhőalapú REST API-funkciója. A Text Translation API valós idejű, gyors és pontos forrás-célszöveg-fordítást tesz lehetővé. A Text Translation szoftverfejlesztői készlet (SDK) kódtárak és eszközök készlete, amelyek lehetővé teszik a Text Translation REST API-képességek alkalmazásba való egyszerű integrálását. A Text Translation SDK a C#/.NET, a Java, a JavaScript és a Python programozási platformokon érhető el.

Támogatott nyelvek

A Szövegfordítás SDK támogatja a programozási nyelveket és platformokat:

Nyelvi → SDK-verzió	Csomag	Ügyfélkódtár	Támogatott API-verzió
.NET/C# → 1.0.0	NuGet	Azure SDK for .NET	Translator v3.0
Java✱ → 1.0.0	Maven-adattár	Javához készült Azure SDK	Translator v3.0
JavaScript → 1.0.0	npm	Azure SDK for JavaScript	Translator v3.0
Python → 1.0.1	PyPi	Pythonhoz készült Azure SDK	Translator v3.0

✱ A Java-hoz készült Azure Text Translation SDK tesztelése és támogatása Windows, Linux és macOS platformokon történik. Más platformokon nem tesztelik, és nem támogatja az Android-telepítéseket.

Változásnapló és kiadási előzmények

Ez a szakasz a szövegfordítási funkció és a képességek kiadásainak, változásainak, frissítéseinek és fejlesztéseinek verzióalapú leírását tartalmazza.

Translator Text SDK 2024. májusi GA-kiadás

Ez a kiadás a következő frissítéseket tartalmazza:

Translator Text SDK 2023. áprilisi előzetes kiadás

Ez a kiadás a következő frissítéseket tartalmazza:

Szövegfordítási SDK használata az alkalmazásokban

A Szövegfordítás SDK lehetővé teszi a szövegfordítási szolgáltatás használatát és kezelését az alkalmazásban. Az SDK a mögöttes Text Translation REST API-ra épül, így könnyedén használhatja ezeket az API-kat a programozási nyelvi paradigmán belül. Az alábbiak szerint használhatja a Szövegfordítás SDK-t az előnyben részesített programozási nyelvhez:

1. Az SDK-ügyfélkódtár telepítése

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. Az SDK-ügyfélkódtár importálása az alkalmazásba

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. Az ügyfél hitelesítése

Az ügyfélkódtárat használó Translator szolgáltatással való interakció az osztály egy példányának TextTranslationClientlétrehozásával kezdődik. Egy ügyfélobjektum példányosításához szüksége van az API-kulcsra és a régióra. A Text Translation API-kulcs az Azure Portalon található:

Képernyőkép az Azure Portal kulcsairól és végponthelyéről.

A globális végpont használata (alapértelmezett)

string key = "<your-key>";

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

Regionális végpont használata


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

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

A globális végpont használata (alapértelmezett)


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

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

Regionális végpont használata

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. Az alkalmazás létrehozása

Hozzon létre egy ügyfélobjektumot a Szövegfordítás SDK használatához, majd hívja meg az adott ügyfélobjektum metódusát a szolgáltatással való interakcióhoz. Az SDK-k szinkron és aszinkron metódusokat is biztosítanak. További információkért tekintse meg a .NET/C# szövegfordítási mintaadattárát .

Súgóbeállítások

A Microsoft Q &A és a Stack Overflow fórumai a fejlesztői közösség számára érhetők el, hogy kérdéseket tegyenek fel és válaszoljanak az Azure Text Translation szolgáltatással és más szolgáltatásokkal kapcsolatban. A Microsoft figyeli azokat a fórumokat és válaszokat, amelyekre a közösség még nem válaszolt. Annak érdekében, hogy biztosan láthassuk a kérdését, címkézze meg a következővel azure-text-translation: .

Következő lépések

Rövid útmutató a szövegfordításhoz

A szövegfordítás 3.0-s verzióra vonatkozó referencia-útmutatója

Megosztás a következőn keresztül: