Определение пользовательских переводов

  • 5 мин

Хотя модель перевода по умолчанию, используемая azure AI Переводчик, эффективна для общего перевода, может потребоваться разработать решение для перевода для предприятий или отраслей, в которых имеются определенные словари терминов, требующих пользовательского перевода.

Чтобы решить эту проблему, вы можете создать пользовательскую модель, сопоставляющую ваши собственные наборы исходных и целевых терминов. Чтобы создать пользовательскую модель, используйте портал "Пользовательский переводчик", на котором можно:

  1. Создайте рабочую область, связанную с ресурсом Azure AI Переводчик.
  2. Создайте проект.
  3. Отправьте файлы обучающих данных и обучить модель.
  4. Проверьте модель и опубликуйте модель.
  5. Вызовы перевода в API.

Screenshot showing the Custom Translator portal.

Пользовательская модель назначается уникальным идентификатором категории (выделен на снимке экрана), который можно указать при переводе вызовов в ресурс Azure AI Переводчик с помощью параметра категории, что приводит к переводу пользовательской модели вместо модели по умолчанию.

Как вызывать API

Чтобы инициировать перевод, отправьте запрос POST на следующий URL-адрес запроса:

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

Запросу необходимо включить несколько параметров:

  • api-version: требуемая версия API.
  • to: целевой язык для перевода. Например, to=fr для французского языка.
  • category: идентификатор категории.

Запрос также должен содержать ряд обязательных заголовков:

  • Ocp-Apim-Subscription-Key. Заголовок ключа клиента. Например: Ocp-Apim-Subscription-Key=<your-client-key>.
  • Content-Type. Тип содержимого для полезных данных. Обязательный формат: Content-Type: application/json; charset=UTF-8.

Текст запроса должен содержать массив, содержащий объект JSON со Text свойством, указывающим текст, который требуется перевести:

[
    {"Text":"Where can I find my employee details?"}
]

Существуют различные способы отправки запроса в API, включая C#, Python и curl. Например, чтобы выполнить быстрый вызов, можно отправить запрос POST с помощью curl:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

Приведенный выше запрос вызывает перевод предложения с английского на голландский.

Ответ возвращен

Ответ возвращает код ответа, 200 если запрос выполнен успешно. Он также возвращает текст ответа, содержащий переведенный текст, как показано ниже:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

Если запрос не был успешным, то в зависимости от типа ошибки может быть возвращено несколько различных кодов состояния, например 400 (отсутствующие или недопустимые параметры запроса). Ознакомьтесь с кодами состояния ответа для полного списка кодов и их объяснения.

Примечание.

Дополнительные сведения о пользовательском переводе см . в кратком руководстве по созданию, публикации и переводу с помощью пользовательских моделей.