Create a Cognitive Services APIs account in the Azure Portal

To use Microsoft Cognitive Service APIs, you first need to create an account in the Azure portal.

  1. Sign in to the Azure portal.

  2. Click + NEW.

  3. Select AI + Cognitive Services and discover the list of availble APIs. Click on See all to see the entire list of Cognitive Services APIs. Click on the API of your choice to proceed.

    Select Cognitive Services APIs

  4. On the Create page, provide the following information:

    • Account Name: Name of the account. We recommend using a descriptive name, for example AFaceAPIAccount.

    • Subscription: Select one of the available Azure subscriptions in which you have at least Contributor permissions.

    • API Type: Choose the Cognitive Services API you want to use. For more information about the various Cognitive Services APIs available, please refer to the Cognitive Services site.

    Select API type

    • Pricing tier: The cost of your Cognitive Services account depends on the actual usage and the options you choose. For more information about pricing for each API, please refer to the pricing pages.

    • Resource Group: A resource group is a collection of resources that share the same lifecycle, permissions, and policies. To learn more about Resource Groups, see Manage Azure resources through portal.

    • Resource Group Location: This is required only if the API selected is global (not bound to a location). If the API is global and not bound to a location, however, you must specify a location for the resource group where the metadata associated with the Cognitive Services API account will reside. This location will have no impact on the runtime availability of your account. To learn more about resource group, please refer to Manage Azure resources through portal.

    • Explicit acknowledgment of Online Service Terms: In order to create an account, subscription Owners or Contributors (as defined by Azure Role-Based Access Control) need to explicitly acknowledge the terms that apply to Cognitive Services in Online Service Terms.

      The subscription Owner can disable the creation of Cognitive Services account for a specific resource group or subscription through Azure policies by following the article Using Azure portal to assign and manage resource policies and assigning a “Not allowed resource types” policy definition and specifying Microsoft.CognitiveServices/accounts as the target resource type.

      If account creation was disabled, the following error would be displayed at the time of account creation:

      Account creation error

  5. To pin the account to the Azure portal dashboard, click Pin to Dashboard.

  6. Click Create to create the account.

After the Cognitive Services account is successfully deployed, click the tile in the dashboard to view the account information.

You can use the Endpoint URL in the Overview section and keys in the Keys section to start making API calls in your applications.

Display account information

Display account keys

Next Steps