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/ai-services/content-understanding/quickstart/use-rest-api.md
+9-11Lines changed: 9 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,14 +35,12 @@ To get started, you need **An Active Azure Subscription**. If you don't have an
35
35
*[Mac or Linux](https://learn2torials.com/thread/how-to-install-curl-on-mac-or-linux-(ubuntu)-or-windows)
36
36
37
37
38
-
## Get Started with a Prebuilt Analyzer
39
-
Analyzers define how your content will be processed and the insights that will be extracted. We offer [pre-built analyzers](link to pre-built analyzer page) for common use cases. You can [customize pre-built analyzers](link to learn how to customize analyzers) to better fit your specific needs and use cases.
38
+
## Get Started with a prebuilt analyzer
39
+
Analyzers define how your content will be processed and the insights that will be extracted. We offer [pre-built analyzers](link to pre-built analyzer page) for common use cases. You can [customize pre-built analyzers](/how-to/create-a-custom-analyzer) to better fit your specific needs and use cases.
40
40
This quickstart uses pre-built document, image, audio, and video analyzers to help you get started.
41
41
42
-
43
-
44
-
### Send File for Analysis
45
-
#### POST Request
42
+
### Send file for analysis
43
+
#### POST request
46
44
47
45
```bash
48
46
curl -i -X POST "{endpoint}/analyzers/{analyzerId}:analyze?api-version=2025-05-01-preview" \
@@ -77,7 +75,7 @@ Before running the cURL command, make the following changes to the HTTP request:
77
75
---
78
76
79
77
80
-
#### POST Response
78
+
#### POST response
81
79
82
80
The response returns `resultId` that you can use to track the status of this asynchronous analyze operation.
83
81
@@ -95,20 +93,20 @@ The response returns `resultId` that you can use to track the status of this asy
95
93
}
96
94
```
97
95
98
-
### Get Analyze Result
96
+
### Get analyze result
99
97
100
98
Use the `resultId` from the `POST` response above and retrieve the result of the analysis.
101
99
102
100
1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Services instance.
103
101
2. Replace `{resultId}` with the `resultId` from the `POST` response.
104
102
105
-
#### GET Request
103
+
#### GET request
106
104
```bash
107
105
curl -i -X GET "{endpoint}/contentunderstanding/analyzerResults/{resultId}?api-version=2025-05-01-preview" \
108
106
-H "Ocp-Apim-Subscription-Key: {key}"
109
107
```
110
108
111
-
#### GET Response
109
+
#### GET response
112
110
113
111
The 200 (`OK`) JSON response includes a `status` field indicating the status of the operation. If the operation isn't complete, the value of `status` is `running` or `notStarted`. In such cases, you should send the GET request again, either manually or through a script. Wait an interval of one second or more between calls.
114
112
@@ -351,6 +349,6 @@ The 200 (`OK`) JSON response includes a `status` field indicating the status of
351
349
352
350
## Next steps
353
351
354
-
* In this quickstart, you learned how to call the [REST API](REFERENCE LINK) using a pre-built analyzer. See how you can [customize pre-built analyzers](LINK TO CUSTOMIZATION) to better fit your use case.
352
+
* In this quickstart, you learned how to call the [REST API](/rest/api/contentunderstanding/content-analyzers/analyze?view=rest-contentunderstanding-2025-05-01-preview) using a pre-built analyzer. See how you can [create a custom analyzer](/how-to/create-a-custom-analyzer) to better fit your use case.
0 commit comments