你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure Translator 是 Azure Translator 的基于云的 REST API 功能。 文本翻译 API 可实时实现快速准确的源到目标文本翻译。 文本翻译软件开发工具包（SDK）是一组库和工具，可用于将文本翻译 REST API 功能轻松集成到应用程序中。 文本翻译 SDK 适用于 C#/.NET、Java、JavaScript 和 Python 中的编程平台。
支持的语言
文本翻译 SDK 支持编程语言和平台：
| 语言→ SDK 版本 | Package | 客户端库 | 支持的 API 版本 |
|---|---|---|---|
| .NET/C# → 1.0.0 | NuGet | 用于 .NET 的 Azure SDK | 翻译器 3.0 版 |
| Java✱ → 1.0.0 | Maven 存储库 | 用于 Java 的 Azure SDK | 翻译器 3.0 版 |
| JavaScript → 1.0.0 | npm | 用于 JavaScript 的 Azure SDK | 翻译器 3.0 版 |
| Python → 1.0.1 | PyPi | 用于 Python 的 Azure SDK | 翻译器 3.0 版 |
✱ 适用于 Java 的 Azure Translator SDK 在 Windows、Linux 和 macOS 平台上进行测试和支持。 它没有在其他平台上进行测试，也不支持 Android 部署。
更新日志和版本历史记录
此节提供了基于版本的说明，介绍文本翻译特性和功能发布、更改、更新和增强。
Foundry Tools 中的 Azure 翻译工具文本 SDK 2024 年 5 月 (GA) 版本
此版本包括以下更新：
- 版本 1.0.0 （2024-05-21）
- 目标文本翻译 v3.0
- GA 版本发布
Azure 翻译器在 Foundry 工具文本 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.对客户端进行身份验证
使用客户端库与 Translator 交互首先创建类的 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 问答 和 Stack Overflow 论坛可供开发人员社区询问和回答有关 Azure Translator 和其他服务的问题。 Microsoft监视论坛，并回答社区尚未回答的问题。 为了确保我们看到您的问题，请用 azure-text-translation 进行标记。