Add edit

Author: cdpark

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

@@ -13,7 +13,7 @@ ms.date: 11/01/2024
 
 # Call the Image Analysis 3.2 API
 
-This article demonstrates how to call the Image Analysis API version 3.2 to return information about an image's visual features. It also shows you how to parse the returned information using the client SDKs or REST API.
+This article demonstrates how to call the Image Analysis version 3.2 API to return information about an image's visual features. It also shows you how to parse the returned information using the client SDKs or REST API.
 
 This guide assumes you've already [created a Vision resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision) and obtained a key and an endpoint URL. If you're using a client SDK, you also need to authenticate a client object. For more information about these steps, see the [Image Analysis quickstart](../quickstarts-sdk/image-analysis-client-library.md).
 
@@ -25,44 +25,39 @@ The code in this guide uses remote images referenced by URL. You might want to t
 
 When analyzing a remote image, you specify the image's URL by formatting the request body like this: `{"url":"http://example.com/images/test.jpg"}`.
 
-> [!TIP]
-> To analyze a local image, put the binary image data in the HTTP request body.
+To analyze a local image, put the binary image data in the HTTP request body.
 
 #### [C#](#tab/csharp)
 
 In your main class, save a reference to the URL of the image you want to analyze.
 
 [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/ComputerVision/ImageAnalysisQuickstart.cs?name=snippet_analyze_url)]
 
-> [!TIP]
-> To analyze a local image, see the [ComputerVisionClient](/dotnet/api/microsoft.azure.cognitiveservices.vision.computervision.computervisionclient) methods, such as `AnalyzeImageInStreamAsync`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/ComputerVision/ImageAnalysisQuickstart.cs) for scenarios involving local images.
+To analyze a local image, see the [ComputerVisionClient](/dotnet/api/microsoft.azure.cognitiveservices.vision.computervision.computervisionclient) methods, such as `AnalyzeImageInStreamAsync`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/ComputerVision/ImageAnalysisQuickstart.cs) for scenarios involving local images.
 
 #### [Java](#tab/java)
 
 In your main class, save a reference to the URL of the image you want to analyze.
 
 [!code-java[](~/cognitive-services-quickstart-code/java/ComputerVision/src/main/java/ImageAnalysisQuickstart.java?name=snippet_urlimage)]
 
-> [!TIP]
-> To analyze a local image, see the [ComputerVision](/java/api/com.microsoft.azure.cognitiveservices.vision.computervision.computervision) methods, such as `AnalyzeImage`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/ComputerVision/src/main/java/ImageAnalysisQuickstart.java) for scenarios involving local images.
+To analyze a local image, see the [ComputerVision](/java/api/com.microsoft.azure.cognitiveservices.vision.computervision.computervision) methods, such as `AnalyzeImage`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/ComputerVision/src/main/java/ImageAnalysisQuickstart.java) for scenarios involving local images.
 
 #### [JavaScript](#tab/javascript)
 
 In your main function, save a reference to the URL of the image you want to analyze.
 
 [!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ImageAnalysisQuickstart.js?name=snippet_describe_image)]
 
-> [!TIP]
-> To analyze a local image, see the [ComputerVisionClient](/javascript/api/@azure/cognitiveservices-computervision/computervisionclient) methods, such as `describeImageInStream`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/javascript/ComputerVision/ImageAnalysisQuickstart.js) for scenarios involving local images.
+To analyze a local image, see the [ComputerVisionClient](/javascript/api/@azure/cognitiveservices-computervision/computervisionclient) methods, such as `describeImageInStream`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/javascript/ComputerVision/ImageAnalysisQuickstart.js) for scenarios involving local images.
 
 #### [Python](#tab/python)
 
 Save a reference to the URL of the image you want to analyze.
 
 [!code-python[](~/cognitive-services-quickstart-code/python/ComputerVision/ImageAnalysisQuickstart.py?name=snippet_remoteimage)]
 
-> [!TIP]
-> To analyze a local image, see the [ComputerVisionClientOperationsMixin](/python/api/azure-cognitiveservices-vision-computervision/azure.cognitiveservices.vision.computervision.operations.computervisionclientoperationsmixin) methods, such as `analyze_image_in_stream`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/python/ComputerVision/ImageAnalysisQuickstart.py) for scenarios involving local images.
+To analyze a local image, see the [ComputerVisionClientOperationsMixin](/python/api/azure-cognitiveservices-vision-computervision/azure.cognitiveservices.vision.computervision.operations.computervisionclientoperationsmixin) methods, such as `analyze_image_in_stream`. Or, see the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/python/ComputerVision/ImageAnalysisQuickstart.py) for scenarios involving local images.
 
 ---
 
@@ -222,7 +217,7 @@ This section shows you how to parse the results of the API call. It includes the
 > [!NOTE]
 > **Scoped API calls**
 >
-> Some of the features in Image Analysis can be called either directly or through the Analyze API call. For example, you can do a scoped analysis of only image tags by making a request to `<endpoint>/vision/v3.2/tag` (or to the corresponding method in the SDK). See the [reference documentation](/rest/api/computervision/operation-groups?view=rest-computervision-v3.2) for other features that can be called separately.
+> Some of the features in Image Analysis can be called either directly or through the Analyze API call. For example, you can do a scoped analysis of only image tags by making a request to `<endpoint>/vision/v3.2/tag` (or to the corresponding method in the SDK). See the [reference documentation](/rest/api/computervision/operation-groups?view=rest-computervision-v3.2&preserve-view=true) for other features that can be called separately.
 
 #### [REST](#tab/rest)
 
@@ -269,20 +264,20 @@ The service returns a `200` HTTP response, and the body contains the returned da
 See the following list of possible errors and their causes:
 
 * 400
-    * `InvalidImageUrl` - Image URL is badly formatted or not accessible.
-    * `InvalidImageFormat` - Input data isn't a valid image.
-    * `InvalidImageSize` - Input image is too large.
-    * `NotSupportedVisualFeature` - Specified feature type isn't valid.
-    * `NotSupportedImage` - Unsupported image, for example child pornography.
-    * `InvalidDetails` - Unsupported `detail` parameter value.
-    * `NotSupportedLanguage` - The requested operation isn't supported in the language specified.
-    * `BadArgument` - More details are provided in the error message.
+    * `InvalidImageUrl` - Image URL is badly formatted or not accessible
+    * `InvalidImageFormat` - Input data isn't a valid image
+    * `InvalidImageSize` - Input image is too large
+    * `NotSupportedVisualFeature` - Specified feature type isn't valid
+    * `NotSupportedImage` - Unsupported image, for example child pornography
+    * `InvalidDetails` - Unsupported `detail` parameter value
+    * `NotSupportedLanguage` - The requested operation isn't supported in the language specified
+    * `BadArgument` - More details are provided in the error message
 * 415 - Unsupported media type error. The Content-Type isn't in the allowed types:
     * For an image URL, Content-Type should be `application/json`
     * For a binary image data, Content-Type should be `application/octet-stream` or `multipart/form-data`
 * 500
     * `FailedToProcess`
-    * `Timeout` - Image processing timed out.
+    * `Timeout` - Image processing timed out
     * `InternalServerError`