Миграция на Azure AI Translator версии 3

2025-05-19

Примечание.

Переводчик Майкрософт версии 2 не рекомендуется использовать 30 апреля 2018 года. Перенос приложений на версию 3 и новые функциональные возможности, доступные исключительно в версии 3. Поддержка версии 2 была прекращена 24 мая 2021 года.

Общедоступная версия Azure AI Translator версии 3 (V3). Выпуск включает новые функции, устаревшие методы и новый формат отправки и получения данных из службы Переводчик Майкрософт. В этом документе содержатся сведения об изменении конфигурации приложений с целью реализации поддержки версии 3.

В конце этой статьи содержатся полезные ссылки на дополнительные источники информации.

Краткие сведения о функциях

Отсутствие трассировки. В версии 3 функция "Без трассировки" применяется ко всем ценовым категориям на портале Azure. Эта функция означает, что служба не сохраняет текст, отправленный в API версии 3.
JSON — XML заменяет JSON. Все данные, отправляемые службе и получаемые от нее, находятся в формате JSON.
Несколько целевых языков в одном запросе. Метод Перевода принимает несколько to языков для перевода в одном запросе. Например, один запрос может быть на from английском и to немецком, испанском и японском или на любом другом сочетании языков.
Двуязычный словарь — в API добавляется двуязычный метод словаря. Этот метод включает lookup и examples.
Транслитерация — в API добавляется метод транслитерации. Этот метод преобразует слова и предложения из одного письма в другое. Например, из арабского языка в латинский.
Языки — новый метод languages предоставляет сведения о языке в формате JSON для использования с методами translate, dictionary и transliterate.
Нововведения в Translate — новые возможности добавляются в метод translate для поддержки некоторых функций, ранее имевшихся в API версии 2 в качестве отдельных методов. В качестве примера можно привести метод TranslateArray.
Метод преобразования текста в речь больше не поддерживается в переводчике Майкрософт. Функция преобразования текста в речь доступна в службе распознавания речи (Майкрософт).

В следующем списке методов версии 2 и V3 определяются методы и API версии 3, которые предоставляют функциональные возможности, которые пришли с версией 2.

Метод API версии 2	Совместимость API версии 3
`Translate`	Перевести
`TranslateArray`	Перевести
`GetLanguageNames`	Языки
`GetLanguagesForTranslate`	Языки
`GetLanguagesForSpeak`	Служба распознавания речи (Майкрософт)
`Speak`	Служба распознавания речи (Майкрософт)
`Detect`	Обнаружить
`DetectArray`	Обнаружить
`AddTranslation`	Компонент больше не поддерживается.
`AddTranslationArray`	Компонент больше не поддерживается.
`BreakSentences`	Прерывание
`GetTranslations`	Компонент больше не поддерживается.
`GetTranslationsArray`	Компонент больше не поддерживается.

Переход на формат JSON

Интерфейс API перевода Microsoft Translator версии 2 принимал и возвращал данные в формате XML. В версии 3 все отправленные и полученные через API данные имеют формат JSON. XML больше не принимается или возвращается в версии 3.

Это изменение влияет на несколько аспектов приложения, написанного для API перевода текста версии 2. Например, API языков предоставляет сведения о языке для перевода текста, транслитерации и двух методов словаря. Вы можете запросить все сведения о языке для всех методов в одном вызове или по отдельности.

Ключ проверки подлинности

Ключ проверки подлинности, используемый для версии 2, принимается для версии 3. Вам не нужно получить новую подписку. Вы можете смешивать версии 2 и V3 в приложениях в течение годового периода миграции, что упрощает выпуск новых версий при переходе с версии 2-XML на V3-JSON.

Модель ценообразования

Microsoft Translator V3 имеет такую же модель ценообразования, что и версия 2 (за символ, в том числе пробелы). Новые функции в версии V3 внесли некоторые изменения в подсчет символов для финансового учета.

Метод версии 3	Символы, учитываемые при выставлении счетов
`Languages`	Символы не отправлены, не подсчитаны, плата не взимается.
`Translate`	Подсчет выполняется на основе отправляемого количества символов для перевода и количества языков перевода. Отправлено 50 символов, из них 5 учитываются как 50х5.
`Transliterate`	Количество символов, переданных для транслитерации, подсчитывается.
`Dictionary lookup & example`	Количество символов, отправленных для поиска по словарю и в примерах, подсчитывается.
`BreakSentence`	Плата не взимается.
`Detect`	Плата не взимается.

Конечные точки версии 3

Глобальный

api.cognitive.microsofttranslator.com

Методы перевода текста API версии 3

Совместимость и настройки

Примечание.

Microsoft Translator Hub будет закрыт 17 мая 2019 г. Важные сведения о миграции и даты.

Azure AI Translator версии 3 использует нейронный машинный перевод по умолчанию. Поэтому его нельзя использовать с Microsoft Translator Hub. Translator Hub поддерживает только устаревший статистический машинный перевод. Настройка нейронного перевода теперь доступна с помощью Пользовательского переводчика ИИ Azure. Узнайте больше о настройке нейронного машинного перевода

Нейронный перевод с помощью API текста версии 3 не поддерживает использование стандартных категорий (SMT, , speech, techgeneralnn).

Версия	Конечная точка	Соответствие требованиям процессора GDPR	Используйте Translator Hub	Использование Пользовательского переводчика (предварительная версия)
Переводчик версии 2	api.microsofttranslator.com	нет	Да	нет
Переводчик, версия 3	api.cognitive.microsofttranslator.com	Да	нет	Да

Переводчик версии 3

Является общедоступным и полностью поддерживается.
Соответствует требованиям GDPR как обработчик и удовлетворяет всем требованиям сертификации ISO 20000-1 и 20018, а также SOC 3.
Он позволяет вызывать системы перевода нейронных сетей, настраиваемые с помощью Пользовательского переводчика (предварительная версия), новой функции настройки систем нейронного машинного перевода (NMT).
Не предоставляет доступ к пользовательским системам перевода, созданным с помощью Microsoft Translator Hub.

Вы используете версию 3 переводчика, если вы используете конечную точку api.cognitive.microsofttranslator.com.

Переводчик версии 2

Не удовлетворяет требованиям к сертификации SOC 3 и ISO 20001, 20018.
Не позволяет вызывать системы перевода нейронных сетей, настроенные с помощью функции настройки Переводчика.
Предоставляет доступ к пользовательским системам перевода, созданным с помощью центра Переводчик Майкрософт.
Использует конечную точку api.microsofttranslator.com.

Версия Azure AI Translator не создает запись ваших переводов. Ваши переводы никогда не передаются третьим лицам. Дополнительные сведения см. на веб-странице Translator No-Trace.

Ссылки.

Дальнейшие действия

Просмотр документации по Azure AI Translator версии 3.0