Azure Text Translation SDK (előzetes verzió)

Cikk
01/10/2024

Fontos

A Translator szöveges SDK-k jelenleg nyilvános előzetes verzióban érhetők el. A funkciók, a megközelítések és a folyamatok az általános rendelkezésre állás (GA) előtt változhatnak a felhasználói visszajelzések alapján.

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-beta.1	NuGet	Azure SDK for .NET	Translator v3.0
Java✱ → 1.0.0-beta.1	MVN-adattár	Javához készült Azure SDK	Translator v3.0
JavaScript → 1.0.0-beta.1	npm	Azure SDK for JavaScript	Translator v3.0
Python → 1.0.0b1	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 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 TextTranslationClient
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ó:

Screenshot of the keys and endpoint location in the Azure portal.

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 is elérhetők, hogy kérdéseket tegyenek fel és válaszoljanak meg 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: .

További 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: