Get started

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.

Getting your api key

Before you get started, you need to obtain a private api key from our system.

• You can receive a log-in to our platform and API key directly by reaching out to our customer support team, or create an account for yourself on our dashboard page.
• If you already have an account, you can login to vidrovr dashboard. The api key will be displayed on the homepage.
• If you lost your api key, or your login credentials, feel free to email us at contact@vidrovr.com to retrieve your api key.

Upload content

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.

Upload with restful api

You can use either your login credentials or api key to start the uploading. Here’s a sample of using your login credentials.

Sample response

Inside of this response:

• id refers to a uniqle video asset id for the video that was uploaded to the Vidrovr system, this id can be used in metadata and asset retrieval across the whole vidrovr platform. This id is unique and will not be changed.

Get results

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

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

Sample response

Key properties in the response

More api calls

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.

• Upload Content provides the details of how to use our restful upload method, HTTP Live Streaming (HLS)upload, and webhooks interface to upload content.
• Get Results offers explanations of ways to get results back from the system. These methods include
  – get_metadata which is the essential methods to get full metadata from a given video id.
  – get_video_list which provides a list of the video in your account in chronological order.
  – search offers a way to find videos in your account that are all relevant based on the metadata in your account.

Use our dashboard

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.

Understand your api limits

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.