You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cognitive-services/Computer-vision/Vision-API-How-to-Topics/HowToCallVisionAPI.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ manager: nitinme
8
8
ms.service: cognitive-services
9
9
ms.subservice: computer-vision
10
10
ms.topic: how-to
11
-
ms.date: 03/08/2022
11
+
ms.date: 04/11/2022
12
12
ms.custom: "seodec18"
13
13
---
14
14
@@ -24,7 +24,7 @@ The code in this guide uses remote images referenced by URL. You may want to try
24
24
25
25
#### [REST](#tab/rest)
26
26
27
-
WHen analyzing a local image, you put the binary image data in the HTTP request body. For a remote image, you specify the image's URL by formatting the request body like the following: `{"url":"http://example.com/images/test.jpg"}`.
27
+
When analyzing a local image, you put the binary image data in the HTTP request body. For a remote image, you specify the image's URL by formatting the request body like this: `{"url":"http://example.com/images/test.jpg"}`.
28
28
29
29
#### [C#](#tab/csharp)
30
30
@@ -57,17 +57,17 @@ Save a reference to the URL of the image you want to analyze.
57
57
58
58
### Select visual features
59
59
60
-
The Analyze API gives you access to all of the service's image analysis features. Choose which operations to do based on your own use case. See the [overview](../overview.md) for a description of each feature. The examples below add all of the available visual features, but for practical usage you will likely only need one or two.
60
+
The Analyze API gives you access to all of the service's image analysis features. Choose which operations to do based on your own use case. See the [overview](../overview.md) for a description of each feature. The examples below add all of the available visual features, but for practical usage you'll likely only need one or two.
61
61
62
62
#### [REST](#tab/rest)
63
63
64
-
You can specify which features you want to use by setting the URL query parameters of the [Analyze API](https://westus.dev.cognitive.microsoft.com/docs/services/computer-vision-v3-2/operations/56f91f2e778daf14a499f21b). A parameter can have multiple values, separated by commas. Each feature you specify will require additional computation time, so only specify what you need.
64
+
You can specify which features you want to use by setting the URL query parameters of the [Analyze API](https://westus.dev.cognitive.microsoft.com/docs/services/computer-vision-v3-2/operations/56f91f2e778daf14a499f21b). A parameter can have multiple values, separated by commas. Each feature you specify will require more computation time, so only specify what you need.
65
65
66
66
|URL parameter | Value | Description|
67
67
|---|---|--|
68
-
|`visualFeatures`|`Adult`| detects if the image is pornographic in nature (depicts nudity or a sex act), or is gory (depicts extreme violence or blood). Sexually suggestive content (aka racy content) is also detected.|
68
+
|`visualFeatures`|`Adult`| detects if the image is pornographic in nature (depicts nudity or a sex act), or is gory (depicts extreme violence or blood). Sexually suggestive content ("racy" content) is also detected.|
69
69
|`visualFeatures`|`Brands`| detects various brands within an image, including the approximate location. The Brands argument is only available in English.|
70
-
|`visualFeatures`|`Categories`| categorizes image content according to a taxonomy defined in documentation. This is the default value of `visualFeatures`.|
70
+
|`visualFeatures`|`Categories`| categorizes image content according to a taxonomy defined in documentation. This value is the default value of `visualFeatures`.|
71
71
|`visualFeatures`|`Color`| determines the accent color, dominant color, and whether an image is black&white.|
72
72
|`visualFeatures`|`Description`| describes the image content with a complete sentence in supported languages.|
73
73
|`visualFeatures`|`Faces`| detects if faces are present. If present, generate coordinates, gender and age.|
@@ -77,7 +77,7 @@ You can specify which features you want to use by setting the URL query paramete
77
77
|`details`|`Celebrities`| identifies celebrities if detected in the image.|
78
78
|`details`|`Landmarks`|identifies landmarks if detected in the image.|
@@ -180,7 +180,7 @@ This section shows you how to parse the results of the API call. It includes the
180
180
181
181
#### [REST](#tab/rest)
182
182
183
-
The service returns a `200` HTTP response, and the body contains the returned data in the form of a JSON string. The following is an example of a JSON response.
183
+
The service returns a `200` HTTP response, and the body contains the returned data in the form of a JSON string. The following text is an example of a JSON response.
184
184
185
185
```json
186
186
{
@@ -229,12 +229,12 @@ See the following list of possible errors and their causes:
229
229
*`InvalidImageUrl` - Image URL is badly formatted or not accessible.
230
230
*`InvalidImageFormat` - Input data is not a valid image.
231
231
*`InvalidImageSize` - Input image is too large.
232
-
*`NotSupportedVisualFeature` - Specified feature type is not valid.
232
+
*`NotSupportedVisualFeature` - Specified feature type isn't valid.
233
233
*`NotSupportedImage` - Unsupported image, for example child pornography.
Copy file name to clipboardExpand all lines: articles/cognitive-services/Computer-vision/includes/image-analysis-curl-quickstart.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,14 +25,14 @@ Use the Image Analysis REST API to:
25
25
## Prerequisites
26
26
27
27
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
28
-
* Once you have your Azure subscription, <ahref="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision"title="Create a Computer Vision resource"target="_blank">create a Computer Vision resource </a> in the Azure portal to get your key and endpoint. After it deploys, click**Go to resource**.
29
-
* You will need the key and endpoint from the resource you create to connect your application to the Computer Vision service. You'll paste your key and endpoint into the code below later in the quickstart.
28
+
* Once you have your Azure subscription, <ahref="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision"title="Create a Computer Vision resource"target="_blank">create a Computer Vision resource </a> in the Azure portal to get your key and endpoint. After it deploys, select**Go to resource**.
29
+
* You'll need the key and endpoint from the resource you create to connect your application to the Computer Vision service. You'll paste your key and endpoint into the code below later in the quickstart.
30
30
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
31
31
*[cURL](https://curl.haxx.se/) installed
32
32
33
33
## Analyze an image
34
34
35
-
To analyze an image for a variety of visual features, do the following steps:
35
+
To analyze an image for various visual features, do the following steps:
36
36
37
37
1. Copy the following command into a text editor.
38
38
1. Make the following changes in the command where needed:
@@ -131,12 +131,12 @@ To create and run the sample, do the following steps:
131
131
132
132
### Examine the response
133
133
134
-
A successful response writes the thumbnail image to the file specified in`<thumbnailFile>`. If the request fails, the response contains an error code and a message to help determine what went wrong. If the request seems to succeed but the created thumbnail is not a valid image file, it might be that your subscription key is not valid.
134
+
A successful response writes the thumbnail image to the file specified in`<thumbnailFile>`. If the request fails, the response contains an error code and a message to help determine what went wrong. If the request seems to succeed but the created thumbnail isn't a valid image file, it's possible that your subscription key is not valid.
135
135
136
136
137
137
## Next steps
138
138
139
-
In this quickstart, you learned how to install make basic image analysis calls using the REST API. Next, learn more about the Analyze API features.
139
+
In this quickstart, you learned how to make basic image analysis calls using the REST API. Next, learn more about the Analyze API features.
140
140
141
141
> [!div class="nextstepaction"]
142
142
>[Call the Analyze API](../Vision-API-How-to-Topics/HowToCallVisionAPI.md)
0 commit comments