你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

什么是 Azure 文本翻译？

项目
09/03/2024

Azure 文本翻译是翻译器服务的基于云的 REST API 功能，它使用神经网络机器翻译技术跨所有支持的语言实时实现快速且准确的源到目标文本翻译。在本概述中，你将了解文本翻译 REST API 如何支持你为应用程序和工作流构建智能解决方案。

文本翻译文档包含以下文章类型：

快速入门。指导你完成向服务发出请求的入门说明。
操作指南。有关以更具体的方式或自定义方式访问和使用服务的说明。
参考文章。 REST API 文档和基于编程语言的内容。

文本翻译功能

文本翻译支持以下方法：

语言。返回“翻译”、“音译”和“字典查找”操作支持的语言列表。此请求不需要身份验证；只需将以下 GET 请求复制并粘贴到你喜欢的 REST API 工具或浏览器中：
```
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0
```
翻译。使用单个请求将单个源语言文本呈现为多个目标语言文本。
音译。将源语言的字符或字母转换为目标语言的对应字符或字母。
检测。返回源代码语言代码以及用于指示文本翻译和音译是否支持检测到的语言的布尔变量。

注意

可以使用单个 REST API 调用对文本进行文本翻译、音译和检测。
字典查找。返回源术语在目标语言中的等效字词。
字典示例返回源术语和目标术语对的语法结构和上下文示例。

文本翻译部署选项

使用以下资源可将文本翻译添加到项目和应用程序：

通过 Azure 中提供的 REST API访问基于云的翻译器服务。
将 REST API 翻译请求与文本翻译 Docker 容器一起使用。
重要
- 要使用翻译器容器，必须完成并提交适用于门控式服务的 Azure AI 服务应用程序线上请求表单，并获得批准以获取对容器的访问权限。
- 与云产品/服务相比，翻译器容器映像支持的功能有限。

数据驻留

文本翻译数据驻留取决于创建翻译器资源的 Azure 区域：

文本翻译数据驻留

✔️ 功能：文本翻译

服务终结点	请求处理数据中心
全球（推荐）： `api.cognitive.microsofttranslator.com`	最近的可用数据中心。
美洲： `api-nam.cognitive.microsofttranslator.com`	美国东部 2 • 美国西部 2
亚太： `api-apc.cognitive.microsofttranslator.com`	日本东部 • 东南亚
欧洲（瑞士除外）： `api-eur.cognitive.microsofttranslator.com`	法国中部 • 西欧
瑞士：有关详细信息，请参阅瑞士服务终结点。	瑞士北部 • 瑞士西部

瑞士服务终结点

资源位于瑞士北部或瑞士西部的客户可以确保其文本 API 请求在瑞士境内得到处理。为了确保请求在瑞士得到处理，请在 Resource regionSwitzerland North 或 Switzerland West 创建翻译器资源，然后在 API 请求中使用该资源的自定义终结点。

例如：如果在 Azure 门户中 Resource region 为 Switzerland North 的情况下创建翻译器资源，并且资源名称为 my-swiss-n，则自定义终结点为 https://my-swiss-n.cognitiveservices.azure.com。要转换的示例请求如下：

// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v

自定义翻译工具目前在瑞士不可用。

开始使用文本翻译

准备好开始了吗？

在 Azure 门户中创建一个翻译器资源。
获取访问密钥和 API 终结点。身份验证需要终结点 URL 和只读密钥。
探究我们的快速入门并查看以下编程语言的用例和代码示例：

后续步骤

深入了解文本翻译 REST API：

请参阅 REST API 参考

通过