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

Из этой статьи вы узнаете, как создать ресурс Переводчик в портал Azure. Azure AI Переводчик — это облачная служба машинного перевода, которая входит в семейство служб ИИ 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>');
    

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

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

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

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

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

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

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

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

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

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

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

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

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

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