Поделиться через

Azure Translator в средстве Foundry 3.0: обнаружение

Определяет язык текста.

URL-адрес запроса

Отправьте запрос в POST :

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

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

Параметры запроса

Параметры запроса, передаваемые в строке запроса:

Параметр запроса Description
версия API Обязательный параметр.
Версия API, запрошенная клиентом. Необходимое значение: 3.0.

К заголовкам запроса относятся:

Headers Description
Заголовки проверки подлинности Обязательный заголовок запроса.
См. доступные параметры проверки подлинности.
Тип контента Обязательный заголовок запроса.
Указывает тип контента полезных данных. Возможные значения: application/json
Длина содержимого Необязательно.
Длина текста запроса.
X-ClientTraceId Необязательно.
Идентификатор GUID, созданный клиентом, однозначно идентифицирует запрос. Этот заголовок можно опустить, если в строку запроса включен идентификатор трассировки с помощью параметра запроса с именем ClientTraceId.

Основное содержание запроса

Текст запроса — это массив JSON. Каждый элемент массива представляет собой объект JSON со строковым свойством.Text Обнаружение языка применяется к значению Text свойства. Автоопределение языка лучше работает с длинным входным текстом. Пример текста запроса выглядит следующим образом:

[
    { "text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Действительны следующие ограничения.

  • Массив может содержать не более 100 элементов.
  • Весь текст, включенный в запрос, не может превышать 50 000 символов, включая пробелы.

Текст ответа

Успешный ответ — это массив JSON с одним результатом для каждой строки в входном массиве. Результирующий объект содержит следующие свойства:

  • language: код обнаруженного языка.

  • score: значение с плавающей запятой, указывающее достоверность результата. Оценка составляет от нуля до одного, а низкая оценка указывает на низкую достоверность.

  • isTranslationSupported: логическое значение, которое имеет значение true, если обнаруженный язык является одним из языков, поддерживаемых для перевода текста.

  • isTransliterationSupported: логическое значение, которое имеет значение true, если обнаруженный язык является одним из языков, поддерживаемых для транслитерации.

  • alternatives: массив других возможных языков. Каждый элемент массива является другим объектом, следующими свойствами: language, , scoreisTranslationSupportedи isTransliterationSupported.

Пример ответа JSON:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Заголовки ответа

Headers Description
X-RequestId Значение, созданное службой для идентификации запроса и используемого для устранения неполадок.

Коды состояния ответа

Ниже приведены возможные коды состояния HTTP, возвращаемые запросом.

Код состояния Description
200 Успех.
400 Один из параметров запроса отсутствует или недопустим. Перед повторным повтором исправьте параметры запроса.
401 Не удалось выполнить проверку подлинности запроса. Убедитесь, что учетные данные указаны и допустимы.
Ошибка 403: Доступ запрещён Запрос не авторизован. Проверьте сообщение об ошибке сведений. Этот код часто указывает, что используются все бесплатные переводы, предоставляемые пробной подпиской.
429 Сервер отклонил запрос, так как клиент превысил ограничения запроса.
500 Произошла непредвиденная ошибка. Если ошибка сохраняется, сообщите о ней со следующими датами и временем сбоя, идентификатором запроса из заголовка X-RequestIdответа и идентификатором клиента из заголовка X-ClientTraceIdзапроса.
503 (Сервис временно недоступен) Сервер временно недоступен. Повторите запрос. Если ошибка сохраняется, сообщите о ней со следующими датами и временем сбоя, идентификатором запроса из заголовка X-RequestIdответа и идентификатором клиента из заголовка X-ClientTraceIdзапроса.

Если возникает ошибка, запрос возвращает ответ на ошибку JSON. Код ошибки — это 6-значный номер, объединяющий код состояния HTTP с 3 цифрами, за которым следует 3-значный номер, чтобы дополнительно классифицировать ошибку. Распространенные коды ошибок можно найти на справочной странице переводчика версии 3.

Примеры

В следующем примере показано, как получить языки, поддерживаемые для перевода текста.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"
  • Last updated on