Что такое перевод текста Azure?

2025-04-01

Перевод текста Azure — это облачная функция REST API службы Переводчика, которая использует технологию нейронного машинного перевода, чтобы обеспечить быстрый и точный перевод текста в целевой код в режиме реального времени на всех поддерживаемых языках. В этом обзоре вы узнаете, как REST API перевода текста позволяют создавать интеллектуальные решения для приложений и рабочих процессов.

Документация по переводу текста включает статьи следующих типов:

Краткие руководства. Инструкции по началу работы, которые помогут вам в процессе отправки запросов в службу.
Практические руководства. Инструкции для получения доступа к службе и более специфического или специализированного ее использования.
Справочные статьи. Документация REST API и содержимое на языке программирования.

Возможности Перевода текста

Преобразование текста поддерживает следующие методы:

Языки. Возвращает список языков, поддерживаемых операциями Translate (Перевод), Transliterate (Транслитерация) и Dictionary Lookup (Поиск по словарю). Этот запрос не требует проверки подлинности; Просто скопируйте и вставьте следующий запрос GET в избранное средство REST API или браузер:
```
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0
```
Translate (Перевод). Перевод текста с одного исходного языка на несколько целевых языков по одному запросу.
Transliterate (Транслитерация). Преобразование символов или букв исходного языка в соответствующие им символы и буквы на целевом языке.
Обнаружение Этот вызов возвращает код языка для исходного текста и логическую переменную с отметкой о том, поддерживается ли перевод текста и транслитерация для обнаруженного языка.

Примечание.

Вы можете переводить, транслитерировать и определять текст с помощью одного вызова REST API.
Dictionary lookup (Поиск по словарю). Возвращает слова, эквивалентные исходному термину, на целевом языке.
Dictionary example (Пример из словаря). Возвращает грамматическую структуру и примеры контекста для пары исходного и целевого терминов.

Параметры развертывания перевода текста

Следующие ресурсы помогут вам добавить Перевод текста в проекты и приложения.

Доступ к облачной службе "Переводчик" осуществляется с помощью REST API в Azure.
Используйте запрос перевода в REST API с контейнером Docker для перевода текста.
Это важно
- Чтобы использовать контейнер Переводчика, необходимо заполнить и отправить онлайн форму запроса на применение для ограниченных служб Azure AI, чтобы получить одобрение для доступа к контейнеру.
- Образ контейнера службы "Переводчик" поддерживает ограниченный набор функций по сравнению с обычными облачными предложениями.

Место расположения данных

Расположение данных перевода текста зависит от региона Azure, в котором был создан ресурс Переводчика:

Размещение данных перевода текста

✔️ Функция: переводчик текста

Конечная точка службы	Центр обработки запросов данных
Глобальный (рекомендуется): `api.cognitive.microsofttranslator.com`	Ближайший доступный центр обработки данных.
Северная и Южная Америка: `api-nam.cognitive.microsofttranslator.com`	Восточная часть США 2 • Западная часть США 2
Азиатско-Тихоокеанский регион: `api-apc.cognitive.microsofttranslator.com`	Восточная Япония • Юго-Восточная Азия
Европа (за исключением Швейцарии): `api-eur.cognitive.microsofttranslator.com`	Центральная Франция • Западная Европа
Швейцария: Дополнительные сведения см. в разделе"Конечные точки службы Швейцарии".	Северная Швейцария • Западная Швейцария

Конечные точки сервисов Швейцарии

Клиенты с ресурсом, расположенным в Северной Или Западной Швейцарии, могут гарантировать, что запросы API текста обслуживаются в Швейцарии. Чтобы убедиться, что запросы обрабатываются в Швейцарии, создайте ресурс Переводчика в Resource region, Switzerland North или Switzerland West, а затем используйте пользовательскую конечную точку этого ресурса в ваших запросах API.

Например, если вы создаете ресурс Переводчика в портале Azure с именем Resource region как Switzerland North, а имя ресурса — my-swiss-n, то конечная точка https://my-swiss-n.cognitiveservices.azure.com — это ваша пользовательская конечная точка. Пример запроса для перевода:

// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v

Пользовательский переводчик в настоящее время недоступен в Швейцарии.

Начало работы с Переводом текста

Готовы приступить?

Создайте ресурс Переводчика на портале Azure.
Получите ключи доступа и конечную точку API. Для проверки подлинности требуются URL-адрес конечной точки и ключ "только для чтения".
Ознакомьтесь с нашим кратким руководством по использованию переводчика с помощью REST и предпочтительного языка программирования. и просмотрите варианты использования и примеры кода для следующих языков программирования:

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

Подробно изучите REST API "Перевод текста":

Справочник по REST API