Azure 文字翻譯 SDK (預覽)

文章
04/11/2024

重要

目前翻譯工具文字 SDK 處於公開預覽狀態。根據使用者意見反應，功能、方法和流程在正式發行 (GA) 之前可能會有所變更。

Azure 文字翻譯是 Azure AI 翻譯工具服務的雲端式 REST API 功能。文字翻譯 API 可讓您即時進行快速且精確的來源對目標文字翻譯。文字翻譯軟體開發套件 (SDK) 是一組程式庫和工具，可讓您輕鬆地將文字翻譯 REST API 功能整合到應用程式中。您可在 C#/.NET、Java、JavaScript 和 Python 的程式設計平台上使用文字翻譯 SDK。

支援的語言

文字翻譯 SDK 支援以下程式設計語言和平台：

語言→ SDK 版本	套件	用戶端程式庫	支援的 API 版本
.NET/C# → 1.0.0-beta.1	NuGet (英文)	Azure SDK for .NET	翻譯工具 3.0 版
Java✱ → 1.0.0-beta.1	MVN 存放庫	Azure SDK for Java	翻譯工具 3.0 版
JavaScript → 1.0.0-beta.1	npm \(英文\)	Azure SDK for JavaScript	翻譯工具 3.0 版
Python → 1.0.0b1	PyPi	Azure SDK for Python	翻譯工具 3.0 版

✱ 已在 Windows、Linux 和 macOS 平台上測試並支援適用於 Java 的 Azure 文字翻譯 SDK。未在其他平台上進行測試，也不支援 Android 部署。

變更記錄和版本歷程記錄

本節提供文字翻譯特徵和功能版本、變更、更新和增強功能的版本描述。

翻譯工具文字 SDK 2023 年 4 月預覽版本

此版本包括下列更新︰

在應用程式中使用文字翻譯 SDK

文字翻譯 SDK 可讓您在應用程式中使用和管理文字翻譯服務。 SDK 建置於基礎文字翻譯 REST API 上，可讓您輕鬆地在程式設計語言範例內使用這些 API。以下是您如何將文字翻譯 SDK 用於您偏好的程式設計語言：

1.安裝 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.將 SDK 用戶端程式庫匯入您的應用程式中

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.驗證用戶端

使用用戶端程式庫與翻譯工具服務的互動，會從建立 TextTranslationClient 類別的執行個體開始。您需要 API 金鑰和區域來具現化用戶端物件。在 Azure 入口網站中找到文字翻譯 API 金鑰：

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

使用全域端點 (預設)

string key = "<your-key>";

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

使用區域端點


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

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

使用全域端點 (預設)


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

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

使用區域端點

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.建置應用程式

建立用戶端物件以與文字翻譯 SDK 互動，然後在該用戶端物件上呼叫與服務互動的方法。 SDK 同時提供同步和非同步方法。如需詳細資訊，請參閱適用於 .NET/C# 的文字翻譯範例存放庫。

說明選項

Microsoft Q&A 和 Stack Overflow 論壇可供開發人員社群詢問和回答有關 Azure 文字翻譯和其他服務的問題。 Microsoft 會監視論壇，並回覆社群尚未回答的問題。若要確保我們會看到您的問題，請使用 azure-text-translation 加以標記。

下一步

文字翻譯快速入門

文字翻譯 3.0 版參考指南

分享方式：