API Walkthrough

The following is a detailed, step-by-step walkthrough of an example enhancement with the Video AI API

Step 1: Create a Video Request

The following will create a new video enhancement request. Simply include some details about the source video, output parameters, and desired enhancements. To access our most up-to-date functionality, please look at our API Reference page. This endpoint is free to use and does not consume any credits.

👆

Click the recipe above to access our pre-built API request

Once this endpoint is called, you will receive a time estimate, cost estimate, and requestID in the response body. You'll need the requestID to move onto the next step.

Step 2: Accept and Upload the Video Request

Accept

After you have submitted the video request - you can choose to continue by calling this endpoint.

👆

Click the recipe above to access our pre-built API request

Upload

Once this endpoint is called, you will receive a set of URL(s). For convenience, you may use the following code snippet to upload the video to that link from your local device. In this example, we will upload the entire video file to a single URL due to its small file size. If you receive more than one URL, please follow the segmentation instructions described here.

👆

Click the recipe above to access our pre-built API request

Once uploaded, you'll receive some information about your upload, including your eTag number. This will be useful for the next step.

Step 3: Complete the Video Upload

After you have finished uploading your video segments, you may use the following request to confirm that all of your video segments have been received. Once this endpoint is called, you video will begin processing with its enhancements.

👆

Click the recipe above to access our pre-built API request

You should receive a response confirming that your request is queued for processing once you have called the endpoint.

Step 4: Get the Video Status

You may use the following request to view the status of your video request

👆

Click the recipe above to access our pre-built API request

Once your video has finished processing, you will receive a link to download your video as a response to this endpoint.

🎉

Congratulations! You just completed your first Video AI API request :)