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

Статья
02/04/2025

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

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

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

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

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

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

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

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

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

Примечание.

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

Обязательно введите правильное значение в name поле, чтобы обеспечить правильную функциональность.

Ценовая категория. Выберите ценовую категорию, соответствующую вашим потребностям.
- У всех подписок есть уровень "Бесплатный".
- Уровень "Бесплатный" поддерживает те же компоненты и функциональные возможности, что и платные планы, и является бессрочным.
- Доступно только один ресурс уровня "Бесплатный" для каждой подписки.
- Перевод документов поддерживается на платных уровнях. Language Studio поддерживает только уровни экземпляров S1 или D3. Если вы просто хотите попробовать перевод документов, выберите уровень экземпляра Standard S1.
Если вы создали ресурс с несколькими службами, ссылки на вкладке "Основные сведения" предоставляют техническую документацию по соответствующей операции службы.
Выберите Review + Create (Просмотреть и создать).
Просмотрите условия службы и выберите "Создать ", чтобы развернуть ресурс.
После успешного развертывания ресурса выберите "Перейти к ресурсу".

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

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

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

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

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

После развертывания нового ресурса выберите "Перейти к ресурсу " или перейдите на страницу ресурсов.
В области навигации слева в разделе "Управление ресурсами" выберите "Ключи" и "Конечная точка".
Скопируйте и вставьте ключи и URL-адрес конечной точки в удобное расположение, например Блокнот.

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

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

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

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

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

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

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

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

Выполните поиск и выберите группы ресурсов в портал Azure и выберите свою группу ресурсов.
Выберите ресурсы, которые необходимо удалить, установив соседний флажок.
Выберите Удалить в верхнем меню рядом с правой границей.
Введите удаление в диалоговом окне "Удалить ресурсы".
Выберите команду Удалить.

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

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

Начало работы с REST API Azure AI Translator

В нашем кратком руководстве вы узнаете, как использовать службу Переводчика с ИНТЕРФЕЙСами REST API.

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

Next Steps

Дополнительные сведения о функциях Azure AI Translator:

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