Azure 文本翻译 SDK（预览版）

项目
07/22/2024

重要

文本翻译 SDK 目前以公共预览版提供。在正式发布 (GA) 之前，根据用户反馈，功能、方法和流程可能会发生更改。

Azure 文本翻译是 Azure AI 翻译服务的一项基于云的 REST API 功能。文本翻译 API 支持实时快速准确地进行源到目标文本翻译。文本翻译软件开发工具包 (SDK) 是一组库和工具，可用于轻松地将文本翻译 REST API 功能集成到应用程序中。文本翻译 SDK 可跨 C#/.NET、Java、JavaScript 和 Python 编程平台使用。

支持的语言

文本翻译 SDK 支持编程语言和平台：

语言 → SDK 版本	包	客户端库	支持的 API 版本
.NET/C# → 1.0.0-beta.1	NuGet	用于 .NET 的 Azure SDK	翻译器 3.0 版
Java✱ → 1.0.0-beta.1	Maven 存储库	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 版

✱ 适用于 Java 的 Azure 文本翻译 SDK 已在 Windows、Linux 和 macOS 平台上经过测试且受到支持。它没有在其他平台上进行测试，也不支持 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 密钥和区域来实例化客户端对象。文本翻译 API 密钥位于 Azure 门户中：

该屏幕截图显示了 Azure 门户中密钥和终结点的位置。

使用区域终结点


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>";
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# 的文本翻译示例存储库。

帮助选项

Azure Q&A 和 Stack Overflow 论坛可供开发人员社区提出和回答有关 Azure 文本翻译和其他服务的问题。 Microsoft 会监视论坛并回复社区尚未回答的问题。为确保我们看到你的问题，请将其标记为 azure-text-translation。

后续步骤

文本翻译快速入门

文本翻译 v3.0 参考指南

通过