Создание Cognitive Services ресурса с помощью портал AzureCreate a Cognitive Services resource using the Azure portal

Используйте это краткое руководство, чтобы приступить к работе с Azure Cognitive Services с помощью портал Azure.Use this quickstart to get started with Azure Cognitive Services using the Azure portal. Cognitive Services представлены ресурсами Azure, созданными в подписке Azure.Cognitive Services are represented by Azure resources that you create in your Azure subscription. После создания ресурса используйте ключи и конечную точку, созданные для проверки подлинности приложений.After creating the resource, Use the keys and endpoint generated for you to authenticate your applications.

предварительные требованияPrerequisites

Типы ресурсов службы "служба Azure для себя"Azure Cognitive Service resource types

Примечание

Владельцы подписки могут отключить создание Cognitive Services ресурсов для групп ресурсов и подписок, применив политику Azure, назначив определение политики "запрещенные типы ресурсов" и указав Microsoft. CognitiveServices/Accounts как тип целевого ресурса.Subscription owners can disable the creation of Cognitive Services resources for resource groups and subscriptions by applying Azure policy, assigning a “Not allowed resource types” policy definition, and specifying Microsoft.CognitiveServices/accounts as the target resource type.

Вы можете получить доступ к Cognitive Services Azure с помощью двух разных ресурсов: Ресурс с несколькими службами или один сервис.You can access Azure Cognitive Services through two different resources: A multi-service resource, or a single-service one. Эти подписки позволяют одновременно подключиться к одной службе или нескольким службам.These subscriptions let you connect to either a single service or multiple services at once.

Ресурс с несколькими службамиMulti-service resource

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

Сейчас некоторые службы не поддерживают ключи для нескольких служб: QnA Maker, службы речи, Пользовательское визуальное распознавание и детектор аномалий.At this time, these services don't support multi-service keys: QnA Maker, Speech Services, Custom Vision, and Anomaly Detector.

Подписка на ресурс Cognitive Services с несколькими службами:Subscribing to a multi-service Cognitive Services resource:

  • Позволяет использовать один ресурс Azure для большинства Cognitive Services Azure.Lets you use a single Azure resource for most Azure Cognitive Services.
  • Консолидация счетов из используемых вами служб.Consolidates billing from the services you use. Дополнительные сведения см. на странице Цены на Cognitive Services.See Cognitive Services pricing for additional information.

Ресурс с одной службойSingle-service resource

Ресурсы одной службы (например, Компьютерное зрение или службы речи) ограничены указанной службой.Single-service resources (such as Computer Vision or Speech Services) are restricted to their specified service.

Создание нового ресурса Azure Cognitive ServicesCreate a new Azure Cognitive Services resource

Перед созданием ресурса Cognitive Services необходимо иметь группу ресурсов Azure, в которой будет содержаться ресурс.Before creating a Cognitive Services resource, you must have an Azure resource group to contain the resource. При создании нового ресурса можно либо создать новую группу ресурсов, либо использовать существующую.When you create a new resource, you have the option to either create a new resource group, or use an existing one. В этой статье показано, как создать новую группу ресурсов.This article shows how to create a new resource group.

  1. Войдите на портал Azure и щелкните +Создать ресурс.Sign in to the Azure portal, and click +Create a resource.

    Выбор API-интерфейсов Cognitive Services

  2. Доступные Cognitive Services можно найти следующими способами.You can find available Cognitive Services with in the following ways:

    • Используйте панель поиска и введите имя службы, на которую вы хотите подписываться.Use the search bar and enter the name of the service you want to subscribe to.

      • Чтобы создать ресурс с несколькими службами, введите Cognitive Services в строке поиска и выберите ресурс Cognitive Services .To create a multi-service resource, enter Cognitive Services in the search bar, and select the Cognitive Services resource.

      Поиск по запросу "Cognitive Services"

    • Чтобы просмотреть все доступные средства, выберите AI + машинное обучениев Azure Marketplace.To see all available cognitive services, select AI + Machine Learning, under Azure Marketplace. Если вы не видите интересующую вас службу, щелкните Показать все и прокрутите до Cognitive Services.If you don't see the service you're interested in, click on See all and scroll to Cognitive Services. Щелкните Дополнительно , чтобы просмотреть весь каталог API-интерфейсы Cognitive Services.Click More to view the entire catalog of Cognitive Services APIs.

      Выбор API-интерфейсов Cognitive Services

  3. На странице Создание введите приведенные ниже сведения.On the Create page, provide the following information:

    Важно!

    Запомните расположение Azure, так как оно может потребоваться при вызове Cognitive Services Azure.Remember your Azure location, as you may need it when calling the Azure Cognitive Services.

    NameName Описательное имя для ресурса Cognitive Services.A descriptive name for your cognitive services resource. Например, микогнитивесервицесаккаунт.For example MyCognitiveServicesAccount.
    ПодпискаSubscription Выберите одну из доступных подписок Azure.Select one of your available Azure subscriptions.
    LocationLocation Расположение экземпляра Cognitive Service.The location of your cognitive service instance. Разные расположения могут увеличивать задержку, но не влияют на доступность среды выполнения ресурса.Different locations may introduce latency, but have no impact on the runtime availability of your resource.
    Ценовая категорияPricing tier Затраты на учетную запись Cognitive Services зависят от выбранных параметров и использования.The cost of your Cognitive Services account depends on the options you choose and your usage. Дополнительные сведения см. на странице с ценами API-интерфейсов.For more information, see the API pricing details.
    Группа ресурсовResource group Группа ресурсов Azure, которая будет содержать ресурс Cognitive Services.The Azure resource group that will contain your Cognitive Services resource. Вы можете создать новую группу или добавить к имеющейся группе.You can create a new group or add it to a pre-existing group.

    Снимок экрана создания ресурса

Получение ключей для ресурсаGet the keys for your resource

После создания ресурса вы можете получить к нему доступ на панели мониторинга Azure, если она закреплена.After creating your resource, you can access it from the Azure dashboard if you pinned it. В противном случае его можно найти в Группе ресурсов.Otherwise, you can find it in Resource Groups. Выбрав ресурс, можно получить ключи, выбрав ключи в разделе Управление ресурсами.After selecting your resource, you can get the keys by selecting Keys under Resource Management.

Настройка переменной среды для проверки подлинностиConfigure an environment variable for authentication

Приложения должны проходить аутентификацию доступа к Cognitive Services, они используют.Applications need to authenticate access to the Cognitive Services they use. Для проверки подлинности, рекомендуется создать переменную среды для хранения ключей для ресурсов Azure.To authenticate, we recommend creating an environment variable to store the keys for your Azure Resources.

После получения ключа, записать в переменную среды на локальном компьютере под управлением приложения.After you have your key, write it to a new environment variable on the local machine running the application. Чтобы задать переменную среды, откройте окно консоли и следуйте инструкциям для используемой операционной системы.To set the environment variable, open a console window, and follow the instructions for your operating system. Замените your-key с одним из ключей для ресурса.Replace your-key with one of the keys for your resource.

  • WindowsWindows

    setx COGNITIVE_SERVICE_KEY "your-key"
    

    После добавления переменной среды может потребоваться перезапустить все запущенные приложения, которым может понадобиться считать переменную среды, в том числе окно консоли.After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. Например, если вы используете Visual Studio в качестве редактора, перезапустите Visual Studio перед запуском примера.For example, if you are using Visual Studio as your editor, restart Visual Studio before running the example.

  • LinuxLinux

    export COGNITIVE_SERVICE_KEY=your-key
    

    После добавления переменной среды запустите source ~/.bashrc из окна консоли, чтобы применить изменения.After you add the environment variable, run source ~/.bashrc from your console window to make the changes effective.

  • macOSmacOS

    Измените .bash_profile и добавьте переменную среды.Edit your .bash_profile, and add the environment variable:

    export COGNITIVE_SERVICE_KEY=your-key
    

    После добавления переменной среды запустите source .bash_profile из окна консоли, чтобы применить изменения.After you add the environment variable, run source .bash_profile from your console window to make the changes effective.

Ценовые категории и выставление счетовPricing tiers and billing

Ценовые категории (и сумма, за которую взимается плата) основываются на количестве отправленных вами транзакций с использованием данных проверки подлинности.Pricing tiers (and the amount you get billed) are based on the number of transactions you send using your authentication information. Каждая ценовая категория определяет:Each pricing tier specifies the:

  • Максимальное число разрешенных транзакций в секунду (TPS).maximum number of allowed transactions per second (TPS).
  • функции службы, включенные в ценовой категории.service features enabled within the pricing tier.
  • Стоимость предопределенного количества транзакций.The cost for a predefined amount of transactions. При превышении этого объема взимается плата за дополнительную плату, указанную в сведениях о ценах для вашей службы.Going above this amount will cause an extra charge as specified in the pricing details for your service.

Очистка ресурсовClean up resources

Если вы хотите очистить и удалить подписку Cognitive Services, вы можете удалить ресурс или группу ресурсов.If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. При удалении группы ресурсов также удаляются все другие ресурсы, содержащиеся в этой группе.Deleting the resource group also deletes any other resources contained in the group.

Чтобы удалить группу ресурсов с помощью портала Azure, сделайте следующее:To remove a resource group using the Azure portal:

  1. На портале Azure разверните меню слева, чтобы открыть меню служб, и выберите Resource Groups (Группы ресурсов), чтобы просмотреть список групп ресурсов.In the Azure portal, expand the menu on the left side to open the menu of services, and choose Resource Groups to display the list of your resource groups.
  2. Выберите группу ресурсов для удаления и щелкните правой кнопкой мыши кнопку Дополнительно (...) в правой части списка.Locate the resource group to delete, and right-click the More button (...) on the right side of the listing.
  3. Выберите Удалить группу ресурсов и подтвердите выбор.Select Delete resource group, and confirm.

См. такжеSee also