翻译器 3.0 版

有什么新鲜事吗？

翻译器版本 3.0 提供基于 JSON 的新式 Web API。 它通过将现有功能合并为更少的作来提高可用性和性能，并提供新功能。

• 音译可将一种语言的文本从一个脚本转换为另一个脚本。
• 在一个请求中翻译到多种语言。
• 一个请求中的语言检测、翻译和音译。
• 用于查找字词的替代翻译的字典，以查找反向翻译和示例，其中显示了上下文中使用的术语。
• 更丰富的语言检测结果。

基 URL

在大多数情况下，对 Translator 的请求由最接近请求发起位置的数据中心处理。 如果使用全局终结点时出现数据中心故障，则请求可能会路由到地理位置之外。

若要强制在特定地理位置内处理请求，请使用所需的地理终结点。 所有请求在地理位置内的数据中心之间进行处理。

✔️ 功能：文本翻译

瑞士服务终结点

资源位于瑞士北部或瑞士西部的客户可以确保其文本 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 公有云的所有区域中使用虚拟网络（VNET）功能。 若要启用虚拟网络，请参阅配置 Azure AI 服务虚拟网络。

启用此功能后，必须使用自定义终结点调用 Translator。 无法使用全局翻译器终结点（“api.cognitive.microsofttranslator.com”），并且无法使用访问令牌进行身份验证。

创建 翻译器资源 并允许从所选网络和专用终结点进行访问后，可以找到自定义终结点。

1. 在 Azure 门户中导航到你的翻译工具资源。

2. 从“资源管理”部分选择“网络”。

3. 在“防火墙和虚拟网络”选项卡上，选择“选定的网络和专用终结点”。

   

4. 选择保存以应用更改。

5. 从 资源管理 部分选择 密钥和终结点。

6. 选择 虚拟网络 选项卡。

7. 列出了文本翻译和文档翻译的终结点。

   

下面是使用自定义终结点调用 Translator 的示例请求

// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
     -H "Ocp-Apim-Subscription-Key:<your-key>" \
     -H "Ocp-Apim-Subscription-Region:<your-region>" \
     -H "Content-Type: application/json" \
     -d "[{'Text':'Hello, what is your name?'}]"

指标

指标允许在 Azure 门户中查看翻译器使用情况和可用性信息。 有关详细信息，请参阅 数据和平台指标。

此表列出了可用指标，其中介绍了它们如何用于监视翻译 API 调用。