Azure AI 翻译 V3 迁移

备注

Microsoft Translator V2 已于 2018 年 4 月 30 日弃用。 将您的应用程序迁移到 V3,体验仅在 V3 中提供的新功能。 V2 已于 2021 年 5 月 24 日停用。

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

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

功能摘要

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

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

V2 API 方法 V3 API 兼容性
Translate 翻译
TranslateArray 翻译
GetLanguageNames 语言
GetLanguagesForTranslate 语言
GetLanguagesForSpeak Microsoft 语音服务
Speak Microsoft 语音服务
Detect 检测
DetectArray 检测
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 日停用。 查看重要迁移信息和日期

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

使用 V3 文本 API 的神经翻译不支持使用标准类别(SMTspeechtechgeneralnn)。

版本 端点 GDPR 处理器合规性 使用 Translator Hub
翻译器版本 2 api.translator.azure.cn 是的
Translator 版本 3 api.translator.azure.cn 是的

Translator 版本 3

  • 它已正式发布且完全受支持。
  • 作为处理器符合 GDPR,并满足所有 ISO 20001、20018 以及 SOC 3 认证要求。
  • 不提供对使用 Microsoft Translator Hub 创建的自定义翻译系统的访问权限。

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

Translator 版本 2

  • 不满足所有 ISO 20001、20018 和 SOC 3 认证要求。
  • 不允许您调用通过翻译自定义功能所调整的神经网络翻译系统。
  • 使用 api.microsofttranslator.com 端点。

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

后续步骤