Merge pull request #210761 from Juliako/patch-20

v-ccolin · web-flow · commit 5f41486fc1ac · 2022-09-11T08:43:17.000+01:00
Create create-accounts-intro.md
diff --git a/articles/azure-video-indexer/accounts-overview.md b/articles/azure-video-indexer/accounts-overview.md
@@ -25,40 +25,41 @@ The trial account option is not available on the Azure Government cloud. For oth
 
 ## A paid (unlimited) account
 
-You can later create a paid account where you're not limited by the quota. Two types of paid accounts are available to you: Azure Resource Manager (ARM) and classic. The main difference between the two is account management platform. While classic accounts are built on the API Management, ARM-based accounts management is built on Azure, which enables apply access control to all services with role-based access control (Azure RBAC) natively.
+You can later create a paid account where you're not limited by the quota. Two types of paid accounts are available to you: Azure Resource Manager (recommended) and classic. The main difference between the two is account management platform. 
+
+* ARM-based accounts management is built on Azure, which enables using [Azure RBAC](../role-based-access-control/overview.md).
+* Classic accounts are built on the API Management.
 
 With the paid option, you pay for indexed minutes, for more information, see [Azure Video Indexer pricing](https://azure.microsoft.com/pricing/details/video-indexer/).
 
 When creating a new paid account, you need to connect the Azure Video Indexer account to your Azure subscription and an Azure Media Services account. 
 
-**The recommended paid account type is the ARM-based account**.
+## Create accounts
 
-## To get access to your account
+> [!NOTE]
+> It is recommended to use Azure Video Indexer ARM-based accounts. 
+    
+* [Create an ARM-based (paid) account in Azure portal](create-account-portal.md). To create an account with an API, see [Accounts](/rest/api/videoindexer/accounts?branch=videoindex)
 
-|   | ARM-based |Classic| Trial|
-|---|---|---|---|
-|Get access token | [ARM REST API](https://aka.ms/avam-arm-api) |[Get access token](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Get-Account-Access-Token)|Same as classic
-|Share account| [Azure RBAC(role based access control)](../role-based-access-control/overview.md)| [Invite users](invite-users.md) |Same as classic
+    > [!TIP]
+    > Make sure you are signed in with the correct domain to the [Azure Video Indexer website](https://www.videoindexer.ai/). For details, see [Switch tenants](switch-tenants-portal.md).  
+* [Upgrade a trial account to an ARM-based (paid) account and import your content for free](import-content-from-trial.md).  
+* If you have a classic (paid) account, [connect an existing classic Azure Video Indexer account to an ARM-based account](connect-classic-account-to-arm.md).
 
-## Create accounts
+   Unless your code or infrastructure prevents you from moving from existing classic accounts, you should start using ARM-based accounts.
 
-* Creating ARM accounts. Make sure you are signed in with the correct domain to the [Azure Video Indexer website](https://www.videoindexer.ai/). For details, see [Switch tenants](switch-tenants-portal.md).  
+## To get access to your account
 
-    * You can create an Azure Video Indexer ARM-based account through one of the following:
-    
-      1. The [Azure Video Indexer website](https://aka.ms/vi-portal-link)
-      2. The [Azure portal](https://portal.azure.com/#home)
-      
-    For the detailed description, [Get started with Azure Video Indexer in Azure portal](create-account-portal.md).
-* Upgrade a trial account to an ARM-based account and [import your content for free](import-content-from-trial.md).  
-* [Create classic accounts using API](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Create-Paid-Account).
-* [Connect an existing classic paid Azure Video Indexer account to an ARM-based account](connect-classic-account-to-arm.md).
+|   | ARM-based |Classic| Trial|
+|---|---|---|---|
+|Get access token | [ARM REST API](https://aka.ms/avam-arm-api) |[Get access token](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Get-Account-Access-Token)|Same as classic|
+|Share account| [Azure RBAC(role based access control)](../role-based-access-control/overview.md)| [Invite users](invite-users.md) |Same as classic|
 
 ## Limited access features
 
 This section talks about limited access features in Azure Video Indexer.
 
-|When did I create the account?|Trial Account (Free)|	Paid Account <br/>(classic or ARM-based)|
+|When did I create the account?|Trial account (free)|	Paid account <br/>(classic or ARM-based)|
 |---|---|---|
 |Existing VI accounts <br/><br/>created before June 21, 2022|Able to access face identification, customization and celebrities recognition till June 2023. <br/><br/>**Recommended**: Move to a paid account and afterward fill in the [intake form](https://aka.ms/facerecognition) and based on the eligibility criteria we will enable the features also after the grace period. |Able to access face identification, customization and celebrities recognition till June 2023\*.<br/><br/>**Recommended**: fill in the [intake form](https://aka.ms/facerecognition) and based on the eligibility criteria we will enable the features also after the grace period. <br/><br/>We proactively sent emails to these customers + AEs.|
 |New VI accounts <br/><br/>created after June 21, 2022	|Not able the access face identification, customization and celebrities recognition as of today. <br/><br/>**Recommended**: Move to a paid account and afterward fill in the [intake form](https://aka.ms/facerecognition). Based on the eligibility criteria we will enable the features (after max 10 days).|Azure Video Indexer disables the access face identification, customization and celebrities recognition as of today by default, but gives the option to enable it. <br/><br/>**Recommended**: Fill in the [intake form](https://aka.ms/facerecognition) and based on the eligibility criteria we will enable the features (after max 10 days).|
@@ -70,3 +71,5 @@ For more information, see [Azure Video Indexer limited access features](limited-
 ## Next steps
 
 Make sure to review [Pricing](https://azure.microsoft.com/pricing/details/video-indexer/).
+
+
diff --git a/articles/azure-video-indexer/animated-characters-recognition.md b/articles/azure-video-indexer/animated-characters-recognition.md
@@ -1,6 +1,6 @@
 ---
 title: Animated character detection with Azure Video Indexer
-description: This topic demonstrates how to use animated character detection with Azure Video Indexer.
+description: Azure Video Indexer supports detection, grouping, and recognition of characters in animated content via integration with Cognitive Services custom vision. This functionality is available both through the portal and through the API.
 ms.topic: conceptual
 ms.date: 11/19/2019
 ms.author: juliako
@@ -24,8 +24,8 @@ The following diagram demonstrates the flow of the animated character detection
 
 Depending on a type of your Azure Video Indexer account, different feature sets are available. For information on how to connect your account to Azure, see [Create an Azure Video Indexer account connected to Azure](connect-to-azure.md).
 
-* Trial account: Azure Video Indexer uses an internal Custom Vision account to create model and connect it to your Azure Video Indexer account. 
-* Paid account: you connect your Custom Vision account to your Azure Video Indexer account (if you don’t already have one, you need to create an account first).
+* The trial account: Azure Video Indexer uses an internal Custom Vision account to create model and connect it to your Azure Video Indexer account. 
+* The paid account: you connect your Custom Vision account to your Azure Video Indexer account (if you don’t already have one, you need to create an account first).
 
 ### Trial vs. paid
 
diff --git a/articles/azure-video-indexer/includes/create-accounts-intro.md b/articles/azure-video-indexer/includes/create-accounts-intro.md
@@ -0,0 +1,8 @@
+---
+author: Juliako
+ms.topic: include 
+ms.service: azure-video-indexer
+ms.date: 09/09/2022
+ms.author: juliako
+---
+When you visit the [Azure Video Indexer](https://www.videoindexer.ai/) website for the first time, a trial account is automatically created for you. With the trial account, you get some free indexing minutes. You can later add a paid account. With the paid option, you pay for indexed minutes. For details about available accounts (trial and paid options), see [Azure Video Indexer account types](../accounts-overview.md).
diff --git a/articles/azure-video-indexer/upload-index-videos.md b/articles/azure-video-indexer/upload-index-videos.md
@@ -8,23 +8,10 @@ ms.custom: ignite-fall-2021
 
 # Upload and index your videos
 
-This article shows how to upload and index videos by using the Azure Video Indexer website and the Upload Video API.
-
-When you're creating an Azure Video Indexer account, you choose between:
-
-- A trial account. Azure Video Indexer provides up to 600 minutes of free indexing to website users and up to 2,400 minutes of free indexing to API users.
-- A paid option where you're not limited by a quota. You create an Azure Video Indexer account that's [connected to your Azure subscription and an Azure Media Services account](connect-to-azure.md). You pay for indexed minutes.
-
-For more information about account types, see [Media Services pricing](https://azure.microsoft.com/pricing/details/media-services/).
+This article shows how to upload and index videos by using the Azure Video Indexer website (see [get started with the website](video-indexer-get-started.md)) and the Upload Video API (see [get started with API](video-indexer-use-apis.md)).
 
 After you upload and index a video, you can use [Azure Video Indexer website](video-indexer-view-edit.md) or [Azure Video Indexer Developer Portal](video-indexer-use-apis.md) to see the insights of the video (see [Examine the Azure Video Indexer output](video-indexer-output-json-v2.md)).
 
-When you're uploading videos by using the API, you have the following options:
-
-* Upload your video from a URL (preferred).
-* Send the video file as a byte array in the request body.
-* Use existing an Azure Media Services asset by providing the [asset ID](/azure/media-services/latest/assets-concept). This option is supported in paid accounts only.
-
 ## Supported file formats
 
 For a list of file formats that you can use with Azure Video Indexer, see [Standard Encoder formats and codecs](/azure/media-services/latest/encode-media-encoder-standard-formats-reference).
@@ -55,6 +42,9 @@ After Azure Video Indexer is done analyzing, you get an email with a link to you
 
 You can use the [Upload Video](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Upload-Video) API to upload and index your videos based on a URL. The code sample that follows includes the commented-out code that shows how to upload the byte array.
 
+> [!NOTE]
+> Before you proceed, make sure to review [API recommendations](video-indexer-use-apis.md#recommendations).
+
 ### Configurations and parameters
 
 This section describes some of the optional parameters and when to set them. For the most up-to-date info about parameters, see the [Azure Video Indexer portal](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Upload-Video).
diff --git a/articles/azure-video-indexer/video-indexer-get-started.md b/articles/azure-video-indexer/video-indexer-get-started.md
@@ -11,9 +11,9 @@ ms.custom: mode-other
 
 [!INCLUDE [Gate notice](./includes/face-limited-access.md)]
 
-This quickstart shows you how to sign in to the Azure Video Indexer [website](https://www.videoindexer.ai/) and how to upload your first video. When visiting the Azure Video Indexer website for the first time, a trial account is automatically created for you. With the trial account, you get a certain number of free indexing minutes. You can later add a paid (ARM-based or classic) account. With the paid option, you pay for indexed minutes.
+This quickstart shows you how to sign in to the Azure Video Indexer [website](https://www.videoindexer.ai/) and how to upload your first video. 
 
-For details about available accounts (trial and paid options), see [Azure Video Indexer account types](accounts-overview.md).
+[!INCLUDE [accounts](./includes/create-accounts-intro.md)]
 
 ## Sign up for Azure Video Indexer
 
diff --git a/articles/azure-video-indexer/video-indexer-use-apis.md b/articles/azure-video-indexer/video-indexer-use-apis.md
@@ -10,7 +10,7 @@ ms.custom: devx-track-csharp
 
 Azure Video Indexer consolidates various audio and video artificial intelligence (AI) technologies offered by Microsoft into one integrated service, making development simpler. The APIs are designed to enable developers to focus on consuming Media AI technologies without worrying about scale, global reach, availability, and reliability of cloud platforms. You can use the API to upload your files, get detailed video insights, get URLs of embeddable insight and player widgets, and more.
 
-When visiting the [Azure Video Indexer](https://www.videoindexer.ai/) website for the first time, a trial account is automatically created for you. With the trial account, you get a certain number of free indexing minutes. You can later add a paid account. With the paid option, you pay for indexed minutes. For details about available accounts (trial and paid options), see [Azure Video Indexer account types](accounts-overview.md).
+[!INCLUDE [accounts](./includes/create-accounts-intro.md)]
 
 This article shows how the developers can take advantage of the [Azure Video Indexer API](https://api-portal.videoindexer.ai/).
 
@@ -100,9 +100,19 @@ The Account ID parameter is required in all operational API calls. Account ID is
 
 This section lists some recommendations when using Azure Video Indexer API.
 
+### Uploading
+
 - If you're planning to upload a video, it's recommended to place the file in some public network location (for example, an Azure Blob Storage account). Get the link to the video and provide the URL as the upload file param.
 
 	The URL provided to Azure Video Indexer must point to a media (audio or video) file. An easy verification for the URL (or SAS URL) is to paste it into a browser, if the file starts playing/downloading, it's likely a good URL. If the browser is rendering some visualization, it's likely not a link to a file but to an HTML page.
+When you're uploading videos by using the API, you have the following options:
+
+* Upload your video from a URL (preferred).
+* Send the video file as a byte array in the request body.
+* Use existing an Azure Media Services asset by providing the [asset ID](/azure/media-services/latest/assets-concept). This option is supported in paid accounts only.
+
+### Getting JSON output
+
 - When you call the API that gets video insights for the specified video, you get a detailed JSON output as the response content. [See details about the returned JSON in this topic](video-indexer-output-json-v2.md).
 - The JSON output produced by the API contains `Insights` and `SummarizedInsights` elements. We highly recommend using `Insights` and not using `SummarizedInsights` (which is present for backward compatibility).
 - We do not recommend that you use data directly from the artifacts folder for production purposes. Artifacts are intermediate outputs of the indexing process. They are essentially raw outputs of the various AI engines that analyze the videos; the artifacts schema may change over time. 
