你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure 文本翻译 SDK（预览版）
重要
- 文本翻译 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 | 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 版 |
✱ 适用于 Java 的 Azure 文本翻译 SDK 已在 Windows、Linux 和 macOS 平台上经过测试且受到支持。 它没有在其他平台上进行测试，也不支持 Android 部署。
更改日志和版本历史记录
此部分根据版本来说明文本翻译功能以及功能的各版本、更改、更新和增强。
文本翻译 SDK 2023 年 4 月预览版
此版本包括以下更新：
- 版本 1.0.0-beta.1 (2023-04-17)
- 目标文本翻译 v3.0
- 初始版本发布
在应用程序中使用文本翻译 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
2. 将 SDK 客户端库导入应用程序
using Azure;
using Azure.AI.Translation.Text;
3. 对客户端进行身份验证
使用客户端库与翻译器服务交互时，首先创建 TextTranslationClient 类的实例。 需要使用 API 密钥和区域来实例化客户端对象。
文本翻译 API 密钥位于 Azure 门户中：
使用全局终结点（默认）
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);
4. 生成应用程序
创建客户端对象以与文本翻译 SDK 交互，然后调用该客户端对象上的方法来与服务交互。 SDK 提供同步和异步方法。 如需更多见解，请参阅适用于 .NET/C# 的文本翻译示例存储库。
帮助选项
Microsoft Q&A 和 Stack Overflow 论坛可供开发人员社区提出和回答有关 Azure 文本翻译和其他服务的问题。 Microsoft 会监视论坛并回复社区尚未回答的问题。 为确保我们看到你的问题，请将其标记为 azure-text-translation。