Azure Text Translation SDK (pratinjau)

Artikel
01/10/2024

Penting

SDK teks Penerjemah saat ini tersedia dalam pratinjau publik. Fitur, pendekatan, dan proses dapat berubah, sebelum Ketersediaan Umum (GA), berdasarkan umpan balik pengguna.

Terjemahan Teks Azure adalah fitur REST API berbasis cloud dari layanan azure AI Penerjemah. API Terjemahan Teks memungkinkan terjemahan teks sumber ke target yang cepat dan akurat secara real time. Kit pengembangan perangkat lunak Terjemahan Teks (SDK) adalah sekumpulan pustaka dan alat yang memungkinkan Anda untuk dengan mudah mengintegrasikan kemampuan REST API Terjemahan Teks ke dalam aplikasi Anda. SDK Terjemahan Teks tersedia di seluruh platform pemrograman di C#/.NET, Java, JavaScript, dan Python.

Bahasa yang didukung

Text Translation SDK mendukung bahasa dan platform pemrograman:

Bahasa → versi SDK	Paket	Pustaka klien	Versi API yang didukung
.NET/C# → 1.0.0-beta.1	NuGet	Azure SDK untuk .Net	Penerjemah v3.0
Java✱ → 1.0.0-beta.1	Repositori MVN	Azure SDK untuk Java	Penerjemah v3.0
JavaScript → 1.0.0-beta.1	npm	Azure SDK untuk JavaScript	Penerjemah v3.0
Python → 1.0.0b1	PyPi	Azure SDK untuk Python	Penerjemah v3.0

✱ SDK Terjemahan Teks Azure untuk Java diuji dan didukung di platform Windows, Linux, dan macOS. Ini tidak diuji pada platform lain dan tidak mendukung penyebaran Android.

Riwayat changelog dan rilis

Bagian ini menyediakan deskripsi berbasis versi fitur Terjemahan Teks dan rilis kemampuan, perubahan, pembaruan, dan penyempurnaan.

Penerjemah Text SDK Rilis pratinjau April 2023

Rilis ini mencakup pembaruan berikut:

Menggunakan SDK Terjemahan Teks di aplikasi Anda

SDK Terjemahan Teks memungkinkan penggunaan dan pengelolaan layanan Terjemahan Teks di aplikasi Anda. SDK dibangun pada REST API Terjemahan Teks yang mendasar yang memungkinkan Anda menggunakan API tersebut dengan mudah dalam paradigma bahasa pemrograman Anda. Berikut cara Anda menggunakan SDK Terjemahan Teks untuk bahasa pemrograman pilihan Anda:

1. Instal pustaka klien 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. Impor pustaka klien SDK ke dalam aplikasi Anda

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. Autentikasi klien

Interaksi dengan layanan Penerjemah menggunakan pustaka klien dimulai dengan membuat instans TextTranslationClientkelas. Anda memerlukan kunci dan wilayah API Anda untuk membuat instans objek klien. Kunci API Terjemahan Teks ditemukan di portal Azure:

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

Menggunakan titik akhir global (default)

string key = "<your-key>";

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

Menggunakan titik akhir regional


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

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

Menggunakan titik akhir global (default)


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

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

Menggunakan titik akhir regional

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. Buat aplikasi Anda

Buat objek klien untuk berinteraksi dengan SDK Terjemahan Teks, lalu panggil metode pada objek klien tersebut untuk berinteraksi dengan layanan. SDK menyediakan metode sinkron dan asinkron. Untuk wawasan selengkapnya, lihat repositori sampel Terjemahan Teks untuk .NET/C#.

Opsi bantuan

Forum Microsoft Q&A dan Stack Overflow tersedia bagi komunitas pengembang untuk mengajukan dan menjawab pertanyaan tentang Terjemahan Teks Azure dan layanan lainnya. Microsoft memantau forum dan membalas pertanyaan yang belum dijawab oleh komunitas. Untuk memastikan bahwa kami melihat pertanyaan Anda, tandai dengan azure-text-translation.

Langkah berikutnya

Mulai cepat Terjemahan Teks

Panduan referensi Terjemahan Teks v3.0

Bagikan melalui