Создание ресурса Переводчика

Из этой статьи вы узнаете, как создать ресурс Переводчика в портал Azure. Azure AI Translator — это облачная служба машинного перевода, которая входит в семейство служб ИИ Azure. Ресурсы Azure — это экземпляры служб, которые вы создаете. Все запросы API к службам ИИ Azure требуют URL-адреса конечной точки и ключа только для чтения для проверки подлинности доступа.

Необходимые компоненты

Чтобы приступить к работе, требуется активная учетная запись Azure. Если ее нет, можно создать бесплатную 12-месячную подписку.

Создание ресурса

С помощью учетной записи Azure вы можете получить доступ к службе Переводчика с помощью двух различных типов ресурсов:

  1. Типы ресурсов с одной службой обеспечивают доступ к одному ключу API службы и конечной точке.

  2. Типы ресурсов с несколькими службами позволяют получить доступ к нескольким службам ИИ Azure с помощью одного ключа API и конечной точки.

Заполнение сведений о проекте и экземпляре

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

  1. Подписка. Выберите одну из доступных подписок Azure.

  2. Группа ресурсов. Можно создать новую группу ресурсов или добавить ресурс в уже существующую группу, которая использует тот же жизненный цикл, разрешения и политики.

  3. Область ресурсов. Выберите Глобальный, если для вашего бизнеса или приложения не требуется конкретный регион. Если вы планируете использовать функцию перевода документов с авторизацией управляемого удостоверения, выберите географический регион, например восточная часть США.

  4. Имя. Введите имя для ресурса. Выбранное вами имя должно быть уникальным в Azure.

    Примечание.

    Если вы используете функцию Переводчика, требующую конечной точки личного домена, например перевода документов, значение, введенное в поле "Имя", будет параметром имени личного домена для конечной точки.

  5. Ценовая категория. Выберите ценовую категорию, соответствующую вашим потребностям.

    • У всех подписок есть уровень "Бесплатный".
    • Уровень "Бесплатный" поддерживает те же компоненты и функциональные возможности, что и платные планы, и является бессрочным.
    • Доступно только один ресурс уровня "Бесплатный" для каждой подписки.
    • Перевод документов поддерживается только на платном уровне. Language Studio поддерживает уровни экземпляров S1 и D3. Если вы просто хотите попробовать перевод документов, выберите уровень экземпляра Standard S1.
  6. Если вы создаете ресурс с несколькими службами, ссылки на вкладке "Основные сведения" предоставляют техническую документацию по соответствующей операции службы.

  7. Выберите Review + Create (Просмотреть и создать).

  8. Просмотрите условия службы и выберите "Создать ", чтобы развернуть ресурс.

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

    Ключи проверки подлинности и URL-адрес конечной точки

    Для всех запросов API служб искусственного интеллекта Azure требуется URL-адрес конечной точки и ключ только для чтения для проверки подлинности.

    • Ключи проверки подлинности. Ключ — это уникальная строка, которая передается при каждом запросе к службе перевода. Ключ можно передать через параметр строки запроса или указать в заголовке HTTP-запроса.

    • URL-адрес конечной точки. Используйте глобальную конечную точку в запросе API, если вам не нужен конкретный регион Azure, или пользовательскую конечную точку. Дополнительные сведения см. в разделе "Базовые URL-адреса". Глобальный URL-адрес конечной точки — api.cognitive.microsofttranslator.com.

Получение ключей проверки подлинности и конечной точки

Чтобы выполнить проверку подлинности подключения к ресурсу Переводчика, необходимо найти ключи и конечную точку.

  1. После развертывания нового ресурса выберите "Перейти к ресурсу " или перейдите на страницу ресурсов.

  2. В области навигации слева в разделе "Управление ресурсами" выберите "Ключи" и "Конечная точка".

  3. Скопируйте и вставьте ключи и URL-адрес конечной точки в удобное расположение, например Блокнот.

    Снимок экрана: портал Azure с страницей

Создание клиента перевода текста

Преобразование текста поддерживает как глобальные, так и региональные конечные точки. После получения ключей проверки подлинности необходимо создать экземпляр экземпляра TextTranslationClient, используя AzureKeyCredential для проверки подлинности, для взаимодействия со службой перевода текста:

  1. Чтобы создать глобальную конечную точку TextTranslationClient ресурсов, вам потребуется ключ API ресурсов:

      AzureKeyCredential credential = new('<apiKey>');
      TextTranslationClient client = new(credential);
    
  2. Чтобы создать TextTranslationClient конечную точку регионального ресурса, вам потребуется ключ API ресурсов и имя региона, в котором находится ресурс:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential, '<region>');
    

Создание клиента перевода документов

Используйте API перевода документов для асинхронного перевода больших объемов текста и нескольких документов на разных языках. Для процесса пакетного перевода требуется учетная запись хранения BLOB-объектов Azure с контейнерами хранения для исходного и переведенного документа.

  1. Перевод документов в настоящее время поддерживается в ресурсе Переводчика (с одной службой) с помощью плана обслуживания S1 standard (оплаты по мере использования) или в плане скидки томов D3.

  2. Дополнительные сведения о создании ресурса переводчика для перевода документов см . в разделе "Предварительные требования: использование перевода документов".

Удаление ресурса или группы ресурсов

Предупреждение

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

Для удаления ресурса

  1. Выполните поиск и выберите группы ресурсов в портал Azure и выберите группу ресурсов.

  2. Выберите ресурсы, которые необходимо удалить, установив соседний флажок.

  3. Выберите Удалить в верхнем меню рядом с правой границей.

  4. Введите удаление в диалоговом окне "Удалить ресурсы".

  5. Выберите команду Удалить.

Чтобы удалить группу ресурсов, выполните указанные ниже действия.

  1. Перейдите в группу ресурсов в портал Azure.

  2. Выберите "Удалить группу ресурсов" в верхней строке меню.

  3. Подтвердите удаление, введя имя группы ресурсов и выбрав Удалить.

Следующий шаг