Skip to content

Commit d2a78e1

Browse files
authored
Update video-indexer-use-apis.md
1 parent ded29c2 commit d2a78e1

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

articles/azure-video-indexer/video-indexer-use-apis.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,9 +100,19 @@ The Account ID parameter is required in all operational API calls. Account ID is
100100
101101
This section lists some recommendations when using Azure Video Indexer API.
102102
103+
### Uploading
104+
103105
- 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.
104106
105107
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.
108+
When you're uploading videos by using the API, you have the following options:
109+
110+
* Upload your video from a URL (preferred).
111+
* Send the video file as a byte array in the request body.
112+
* 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.
113+
114+
### Getting JSON output
115+
106116
- 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).
107117
- 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).
108118
- 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.

0 commit comments

Comments
 (0)