Azure 翻译器 V3 迁移

Note

Microsoft 翻译工具 V2 已于 2018 年 4 月 30 日弃用。将应用程序迁移到 V3，体验 V3 中独占提供的新功能。 V2 于 2021 年 5 月 24 日停用。

Azure 翻译器版本 3（V3）已正式发布。该版本包括新功能、弃用的方法以及用于发送到Microsoft 翻译工具以及从Microsoft 翻译工具接收数据的新格式。本文档提供有关更改应用程序以使用 V3 的信息。

本文档末尾包含有用的链接供你了解详细信息。

功能摘要

无跟踪 - 在 V3 中，No-Trace 适用于 Azure 门户中的所有定价层。此功能意味着服务不会保存提交到 V3 API 的文本。
JSON - XML 替换 JSON。发送到服务并从服务接收的所有数据都采用 JSON 格式。
单个请求中的多个目标语言 - Translate 方法接受单个请求中的多个翻译目标 (to) 语言。例如，单个请求可以是 from 英语、德语、 to 西班牙语和日语，也可以是任何其他语言组。
双语词典 - 将双语词典方法添加到 API。此方法包括 lookup 和 examples。
音译 - 已将一个音译方法添加到 API。此方法将一个脚本中的单词和句子转换为另一种脚本。例如，将阿拉伯语转换为拉丁语。
语言 - 新languages方法以 JSON 格式提供语言信息，可用于 translate、dictionary 和 transliterate 方法。
新的翻译功能 - 已将新功能添加到 translate 方法，以支持 V2 API 中作为单独方法提供的某些功能。例如 TranslateArray。
语音方法 - Microsoft 翻译工具不再支持文本转语音功能。 Microsoft 语音服务中提供了文本转语音功能。

以下 V2 和 V3 方法列表指明了能够提供 V2 随附的功能的 V3 方法和 API。

Microsoft 翻译工具翻译 V2 接受 XML 格式的数据，并以此格式返回数据。在 V3 中，使用 API 发送和接收的所有数据都采用 JSON 格式。在 V3 中，不再接受或返回 XML 数据。

此更改会影响为 V2 文本翻译 API 编写的应用程序的几个方面。例如：语言 API 返回文本翻译、音译和两种字典方法的语言信息。可以在一次调用中请求所有方法的所有语言信息，也可以单独请求它们。

V3 接受用于 V2 的身份验证密钥。无需获取新订阅。可以在一年一年的迁移期间在应用中混合 V2 和 V3，以便在从 V2-XML 迁移到 V3-JSON 时更轻松地发布新版本。

Microsoft 翻译工具 V3 的定价方式与 V2 相同：按字符（包括空格）计费。 V3 中的新功能对计费的字符计数进行了一些更改。

V3 方法	用于计费的字符计数
`Languages`	未提交字符，无计数，不收费。
`Translate`	计数基于提交翻译的字符数，以及将字符翻译为多少种语言。提交的 50 个字符，其中 5 个字符被计为 50x5。
`Transliterate`	用于音译的字符数量被计数。
`Dictionary lookup & example`	提交用于字典查找和示例的字符数会被统计。
`BreakSentence`	不收费。
`Detect`	不收费。