Vidrovr provides full api solutions to embed video AI into your platform and products. In this tutotial we will be detailing two core components of our API: how send us your video and how to get the video AI results. Now let’s take a quick tour of how to get your first video running in the Vidrovr machine learning pipeline.
Before you get started, you need to obtain a private api key from our system.
Now, select a file that you’d like to test. We accept all major video file containers and encoders, you can see the full list on the video upload explainer API page.
You can use either your login credentials or api key to start the uploading. Here’s a sample of using your login credentials.
curl -F upload_type='video' -F id=`USERNAME` -F password=`PASSWORD`
-F filename=`FILENAME` -F data=`video_file.mp4`
https://platform.vidrovr.com/upload/uploader
{
"msg":"you just have to play nice",
"id":"c0e4641ed361f76e57bc679f383d9b49315ff97b-f889-4f3e-9efb-eafb7f00d43d",
"resp":"upload_success"
}
Inside of this response:
After you upload your content, Vidrovr’s backend engine will start processing your video. Depending on the size of your file, the processing time will vary. In general, a 30 minute long, standard hi-res (1080p) video will take us 10 minutes to prepare the data.
To get the metadata that we generated for your video, you can use a GET request on the URL below
https://platform.vidrovr.com/public/api/v01/get_metadata?id=&api_key=
Inside of this api call, the api_key is the private api key related to your account from Step 1. The id here refers to the video asset id you get after a successful content upload via our upload api in Step 2.
If the call returns a success, congratulations! You have just received a detailed understading of what is appearing in your video in the form of the Vidrovr metadata
{
"other_metadata":[...],
"audio_words":[...],
"name":"nat_geo_sharks_zone1.mp4",
"tags":[...],
"hashtags":[...],
"scenes":[...],
"id":"...",
"keyphrases":[...],
"on_screen_text":[...]
"person_identification":[...],
"creation_date":1500229993885,
"thumbnail":"..."
}{
"other_metadata":[...],
"audio_words":[...],
"name":"nat_geo_sharks_zone1.mp4",
"tags":[...],
"hashtags":[...],
"scenes":[...],
"id":"...",
"keyphrases":[...],
"on_screen_text":[...]
"person_identification":[...],
"creation_date":1500229993885,
"thumbnail":"..."
}
Our full available api list can be found on Vidrovr api page
On this site, we also go into detail around some of the concepts covered on this page.
Vidrovr also provides a free dashboard which provides a user interface for uploading content, inspect, searching through, and editing metadata, and to configure third party connections and custom model tasks.
For more information and instructions on how to use the dashboard. Please follow this link to learn more.
Your api calls are subject to operation limits, which can be seen in the dashboard. Feel free to reach out to us if you have overused your quota.