Merge pull request #867 from MicrosoftDocs/main

10/17 11:00 AM IST Publish

Author: PhilKang0704

articles/ai-services/computer-vision/concept-background-removal.md

@@ -14,6 +14,8 @@ ms.author: pafarley
 
 # Background removal (version 4.0 preview)
 
+[!INCLUDE [segmentation-deprecation](includes/segmentation-deprecation.md)]
+
 The Background removal operation can divide images into multiple segments or regions to help the user identify different objects or parts of the image. Background removal creates an alpha matte that separates the foreground object from the background in an image. This service is currently in preview, and the API may change in the future.
 
 

articles/ai-services/computer-vision/concept-face-recognition.md

@@ -1,8 +1,7 @@
 ---
 title: "Face recognition - Face"
 titleSuffix: Azure AI services
-description: Learn the concept of Face recognition, its related operations, and the underlying data structures.
-#services: cognitive-services
+description: Learn the concept of Face recognition, its operations, and data structures, including PersonGroup creation, identification, and verification.
 author: PatrickFarley
 manager: nitinme
 
@@ -11,7 +10,7 @@ ms.subservice: azure-ai-face
 ms.custom:
   - ignite-2023
 ms.topic: conceptual
-ms.date: 02/14/2024
+ms.date: 10/16/2024
 ms.author: pafarley
 ---
 
@@ -50,7 +49,7 @@ Use the following tips to ensure that your input images give the most accurate r
 
 [!INCLUDE [identity-input-technical](includes/identity-input-technical.md)]
 [!INCLUDE [identity-input-composition](includes/identity-input-composition.md)]
-* You can utilize the `qualityForRecognition` attribute in the [face detection](./how-to/identity-detect-faces.md) operation when using applicable detection models as a general guideline of whether the image is likely of sufficient quality to attempt face recognition on. Only `"high"` quality images are recommended for person enrollment and quality at or above `"medium"` is recommended for identification scenarios.
+* You can use the `qualityForRecognition` attribute in the [face detection](./how-to/identity-detect-faces.md) operation when using applicable detection models as a general guideline of whether the image is likely of sufficient quality to attempt face recognition on. Only `"high"` quality images are recommended for person enrollment and quality at or above `"medium"` is recommended for identification scenarios.
 
 ## Next steps
 

articles/ai-services/computer-vision/concept-shelf-analysis.md

@@ -8,7 +8,7 @@ manager: nitinme
 
 ms.service: azure-ai-vision
 ms.topic: conceptual
-ms.date: 02/14/2024
+ms.date: 10/16/2024
 ms.author: pafarley
 ms.custom: build-2023, build-2023-dataai
 ---

articles/ai-services/computer-vision/how-to/background-removal.md

@@ -13,6 +13,8 @@ ms.date: 01/19/2024
 
 # Remove the background in images
 
+[!INCLUDE [segmentation-deprecation](../includes/segmentation-deprecation.md)]
+
 This article demonstrates how to call the Image Analysis 4.0 API to segment an image (separate the foreground from background). It also shows you how to parse the returned information.
 
 > [!IMPORTANT]

articles/ai-services/computer-vision/how-to/call-read-api.md

@@ -20,17 +20,6 @@ The following steps assume that you've already created a [Computer Vision resour
 
 [!INCLUDE [read-editions](../includes/read-editions.md)]
 
-## Input requirements
-
-The **Read** API call takes images and documents as its input. The images and documents must meet the following requirements:
-
-* Supported file formats are JPEG, PNG, BMP, PDF, and TIFF.
-* For PDF and TIFF files, up to 2,000 pages (only the first two pages for the free tier) are processed.
-* The file size of images must be less than 500 MB (4 MB for the free tier) with dimensions at least 50 x 50 pixels and at most 10,000 x 10,000 pixels. PDF files don't have a size limit.
-* The minimum height of the text to be extracted is 12 pixels for a 1024 x 768 image, which corresponds to about 8-point font text at 150 DPI.
-
->[!NOTE]
-> You don't need to crop an image for text lines. Send the whole image to the Read API and it recognizes all texts.
 
 ## Determine how to process the data (optional)
 

articles/ai-services/computer-vision/how-to/image-retrieval.md

@@ -1,15 +1,17 @@
 ---
-title: Do image retrieval using multimodal embeddings - Image Analysis 4.0
+title: Image retrieval using multimodal embeddings
 titleSuffix: Azure AI services
-description: Learn how to call the image retrieval API to vectorize image and search terms.
+description: Learn how to use the image retrieval API to vectorize images and search terms, enabling text-based image searches without metadata.
 #services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 
 ms.service: azure-ai-vision
 ms.topic: how-to
-ms.date: 02/20/2024
+ms.date: 10/16/2024
 ms.author: pafarley
+
+#customer intent: As a developer, I want to use the image retrieval API to vectorize images and text so that I can perform text-based image searches.
 ---
 
 # Do image retrieval using multimodal embeddings (version 4.0)
@@ -35,7 +37,7 @@ You can try out the Multimodal embeddings feature quickly and easily in your bro
 > The Vision Studio experience is limited to 500 images. To use a larger image set, create your own search application using the APIs in this guide.
 
 > [!div class="nextstepaction"]
-> [Try Vision Studio](https://portal.vision.cognitive.azure.com/)
+> [Try Vision Studio](https://portal.vision.cognitive.azure.com/gallery/imageanalysis)
 
 ## Call the Vectorize Image API
 
@@ -124,6 +126,7 @@ def cosine_similarity(vector1, vector2):
 
 ---
 
-## Next steps
+## Next step
 
-[Image retrieval concepts](../concept-image-retrieval.md)
+> [!div class="nextstepaction"]
+> [Image retrieval concepts](../concept-image-retrieval.md)

articles/ai-services/computer-vision/includes/curl-quickstart.md

@@ -22,7 +22,6 @@ Use the optical character recognition (OCR) REST API to read printed and handwri
 - [cURL](https://curl.haxx.se/) installed.
 - <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision" title="create a Vision resource" target="_blank">An Azure AI Vision resource</a>. You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 - The key and endpoint from the resource you create to connect your application to the Azure AI Vision service.
-
   1. After your Azure Vision resource deploys, select **Go to resource**.
   1. In the left navigation menu, select **Keys and Endpoint**.
   1. Copy one of the keys and the **Endpoint** for use later in the quickstart.

articles/ai-services/computer-vision/includes/model-customization-deprecation.md

@@ -11,6 +11,6 @@ ms.author: pafarley
 ---
 
 > [!IMPORTANT]
-> This feature is now deprecated. On January 10, 2025, the Azure AI Vision Product Recognition and model customization features will be retired: after this date, API calls to these services will fail.
+> This feature is now deprecated. On January 10, 2025, Azure AI Image Analysis 4.0 Custom Image Classification, Custom Object Detection, and Product Recognition preview API will be retired. After this date, API calls to these services will fail.
 >
 > To maintain a smooth operation of your models, transition to [Azure AI Custom Vision](/azure/ai-services/Custom-Vision-Service/overview), which is now generally available. Custom Vision offers similar functionality to these retiring features.

articles/ai-services/computer-vision/includes/ocr-studio-quickstart.md

@@ -17,7 +17,6 @@ ms.author: pafarley
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/).
 - [An Azure AI Vision resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision). You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 - Connect to [Vision Studio](https://portal.vision.cognitive.azure.com/).
-
   - You might need to sign in.
   - After you sign in, select **View all resources**. If necessary, select **Refresh**. Verify that your resource is available.
 

articles/ai-services/computer-vision/includes/quickstarts-sdk/csharp-sdk.md

@@ -26,7 +26,6 @@ Use the optical character recognition (OCR) client library to read printed and h
 - The [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) or current version of [.NET Core](https://dotnet.microsoft.com/download/dotnet-core).
 - <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision" title="create a Vision resource" target="_blank">An Azure AI Vision resource</a>. You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 - The key and endpoint from the resource you create to connect your application to the Azure AI Vision service.
-
   1. After your Azure Vision resource deploys, select **Go to resource**.
   1. In the left navigation menu, select **Keys and Endpoint**.
   1. Copy one of the keys and the **Endpoint** for use later in the quickstart.