将 Translator V2 迁移到 V3

注意

V2 已于 2018 年 4 月 30 日弃用。 请将应用程序迁移到 V3,以便利用 V3 中专门提供的新功能。 V2 已于 2021 年 5 月 24 日停用。

Microsoft Translator 团队已发布 Translator 版本 3 (V3)。 此版本包括新的功能、弃用了一些方法,并提供与 Microsoft Translator 服务相互发送和接收数据时所用的新格式。 本文档提供有关将应用程序更改为使用 V3 的信息。

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

功能摘要

  • 无跟踪 - 在 V3 中,“无跟踪”将应用到 Azure 门户中的所有定价层。 此功能意味着,Microsoft 不会保存提交到 V3 API 的任何文本。
  • JSON - XML 将由 JSON 取代。 发送到服务的所有数据以及从服务接收的所有数据将采用 JSON 格式。
  • 单个请求中的多个目标语言 - Translate 方法接受单个请求中的多个翻译“目标”语言。 例如,单个请求可以是“从”英语翻译“到”德语、西班牙语和日语,或任何其他语言组。
  • 双语字典 - 已将一个双语字典方法添加到 API。 此方法包括“查找”和“示例”。
  • 音译 - 已将一个 transliterate 方法添加到 API。 此方法会将一个脚本中的单词和句子转换为另一种脚本。 例如,将阿拉伯语转换为拉丁语。
  • 语言 - 新的“languages”方法会提供 JSON 格式的语言信息,以便与“translate”、“dictionary”和“transliterate”方法结合使用。
  • 新的翻译功能 - 已将新功能添加到“translate”方法,以支持 V2 API 中作为单独方法提供的某些功能。 示例包括 TranslateArray。
  • 讲述方法 - Microsoft Translator 不再支持文本转语音功能。 Microsoft 语音服务中提供了文本转语音功能。

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

V2 API 方法 V3 API 兼容性
Translate Translate
TranslateArray Translate
GetLanguageNames 语言
GetLanguagesForTranslate 语言
GetLanguagesForSpeak Microsoft 语音服务
Speak Microsoft 语音服务
Detect Detect
DetectArray Detect
AddTranslation 不再支持的功能
AddTranslationArray 不再支持的功能
BreakSentences BreakSentence
GetTranslations 不再支持的功能
GetTranslationsArray 不再支持的功能

改为 JSON 格式

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

此项更改会影响针对 V2 文本翻译 API 编写的应用程序的多个方面。 例如:语言 API 返回文本翻译、音译和两个字典方法的语言信息。 可以通过一次调用请求所有方法的所有语言信息,或单独请求这些方法的信息。

languages 方法不需要身份验证;选择以下链接可以看到 V3 的 JSON 格式的所有语言信息:

https://api.translator.azure.cn/languages?api-version=3.0&scope=translation,dictionary,transliteration

身份验证密钥

V3 接受对 V2 所用的身份验证密钥。 不需要获取新订阅。 在为期一年的迁移时间段内,可以在应用中混合使用 V2 和 V3,因此可以更轻松地发布新版本,同时逐步地从 V2-XML 迁移到 V3-JSON。

定价模型

Microsoft Translator V3 的定价方式与 V2 相同:按字符(包括空格)计费。 在哪些字符应该计费这一方面,V3 中的新功能做了一些改变。

V3 方法 应计费的字符
Languages 未提交任何字符:不计算字符数,免费。
Translate 根据提交翻译的字符数,以及字符要翻译成的语言数来统计费用。 如果提交了 50 个字符并请求翻译成 5 种语言,则费用是 50x5。
Transliterate 根据提交音译的字符数统计费用。
Dictionary lookup & example 根据提交请求字典查找和示例的字符数统计费用。
BreakSentence 免费。
Detect 免费。

V3 终结点

全球

  • api.translator.azure.cn

V3 API 文本翻译方法

Languages

Translate

Transliterate

BreakSentence

Detect

Dictionary/lookup

Dictionary/example

兼容性和自定义

注意

Microsoft Translator Hub 将于 2019 年 5 月 17 日停用。 查看重要迁移信息和日期

Microsoft Translator V3 默认使用神经机器翻译。 因此,它不能与 Microsoft Translator Hub 一起使用。 Translator Hub 仅支持传统的统计机器翻译。

使用 V3 文本 API 的神经翻译不支持使用标准类别(SMT、语音、技术、generalnn)。

版本 终结点 GDPR 处理器符合性 使用 Translator Hub 使用自定义翻译器(预览版)
Translator 版本 2 api.translator.azure.cn
Translator 版本 3 api.translator.azure.cn No

Translator 版本 3

  • 已正式发布且完全受支持。
  • 作为处理器符合 GDPR,并满足所有 ISO 20001、20018 以及 SOC 3 认证要求。
  • 可用于调用已使用自定义翻译器(预览版,新的 Translator NMT 自定义功能)自定义的神经网络翻译系统。
  • 不提供对使用 Microsoft Translator Hub 创建的自定义翻译系统的访问权限。

如果正在使用 api.translator.azure.cn 终结点,则使用的是 Translator 版本 3。

Translator 版本 2

  • 不满足所有 ISO 20001、20018 和 SOC 3 认证要求。
  • 不可用于调用已使用 Translator 自定义功能自定义的神经网络翻译系统。
  • 提供对使用 Microsoft Translator Hub 创建的自定义翻译系统的访问权限。
  • 如果正在使用 api.microsofttranslator.com 终结点,则使用的是 Translator 版本 2。

任何版本的 Translator 都不会创建翻译的记录。 永远不会与任何人共享你的翻译。 有关详细信息,请参阅 Translator 无跟踪网页。

后续步骤