Azure 翻譯工具 in Foundry Tools V3 Migration

備註

Microsoft 翻譯工具 V2 於 2018 年 4 月 30 日被棄用。將您的應用程式移轉至 V3，並體驗 V3 獨有的新功能。 V2 已於 2021 年 5 月 24 日淘汰。

Azure 翻譯工具版本 3 （V3）已普遍可用。此版本包含新功能、已棄用的方法，以及與 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 翻譯工具 Translation V2 接受並回傳 XML 格式的資料。在 V3 中，使用 API 發送和接收的所有數據都是 JSON 格式。 V3 中不再接受或傳回 XML。

此變更會影響針對 V2 文字翻譯 API 撰寫的應用程式的數個層面。例如：語言 API 會傳回文字翻譯、音譯和兩個字典方法的語言資訊。您可以在一次呼叫中要求所有方法的所有語言資訊，也可以個別要求它們。

用於 V2 的驗證金鑰適用於 V3。您不需要重新訂閱。您可以在一年的遷移期間在應用程式中混合使用 V2 和 V3，讓您在從 V2-XML 遷移到 V3-JSON 時更輕鬆地發布新版本。

Microsoft 翻譯工具 V3 的定價方式與 V2 相同;按字元定價，包含空格。 V3 中的新功能針對哪些字元需計入收費的方式做了一些變更。

V3 方法	需計費的字元
`Languages`	沒有提交任何字符，沒有一個字符被計算在內，沒有收費。
`Translate`	計算是根據提交進行翻譯的字元數量，以及字元被翻譯成多少種語言。提交了 50 個字符，其中 5 個算作 50x5。
`Transliterate`	會計算提交進行音譯的字元數。
`Dictionary lookup & example`	會計算提交給字典查閱的字元數和範例。
`BreakSentence`	不收費。
`Detect`	不收費。