How to use Video Face Detection API with Python in 5 minutes?
Tags: facedetection, python, ai, api
Published: 2023-01-11 14:59:09

*In this tutorial, you will learn how to use Face Detection in Videos in 5 minutes using Python and Eden AI Video Face Detection API. Eden AI provides an easy and developer-friendly API that allows you to detect faces in videos.*

## **What is Video Face Detection?**

Video Face Detection is a technology that can automatically identify human faces in digital video footage. This can be used for security or for various purposes like photo editing or cropping. For example, video face detection can be used to automatically unlock a device when the user's face is recognized.

## **Getting Started with Video Face Detection API**

The first step to using Video Face Detection is to install Python's requests package, that will allow you to call Eden AI API.
![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rct9dsdcioqkbjk59yce.png)
Next, you'll need to install Python's JSON package in order to read and print the result of the API request.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ycjfaq1owr0a079lbyl1.png)

## **How to use Video Face Detection API with Python**

You are now ready to process your video file into Eden AI Video Face Detection API.

### **1. Get a Video Face Detection API Key on Eden AI**

To perform Video Face Detection in videos, you'll need to create an account on [Eden AI](https://app.edenai.run/user/register?referral=how-to-video-face-detection-python)for free. Then, you will be able to get your **API key** direclty from the homepage with free credits offered by Eden AI.

![https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/638e1759a187a524304f5b82_Eden%20AI%20platform%20Get%20your%20API%20key.png](https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/638e1759a187a524304f5b82_Eden%20AI%20platform%20Get%20your%20API%20key.png)

**[Get your API key for FREE](https://app.edenai.run/user/register?referral=how-to-video-face-detection-python)**

### **‍‍2. Let’s Detect Faces in your Video File**

Now that you've imported packages on Python and got your API key, you will be able to detect faces in videos. With Eden AI, you can choose from a wide range of different engines you want for Video Face Detection. You can access all our Video Face Detection providers on our documentation [here](https://docs.edenai.co/reference/video_face_detection_async_create?referral=how-to-video-face-detection-python).

Here is the Python script you need to write on your notebook:
![Video Face Detection API with Python](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/q5l8ixdqa2khpst7ksrd.png)
For example, we called two different Video Face Detection engines. Eden AI API will then return in its JSON response results of those providers.
Eden AI Video Face Detection API is an asynchronous API. It means that you will get in response an ID:
![https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bcf23a02032821bcb0df_explicit-video-post-response.png](https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bcf23a02032821bcb0df_explicit-video-post-response.png)
Then you will need to perform a GET request to check the status of the API request (success, processing, failed):
![https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd07078daa48a4520b02_face-video-get.png](https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd07078daa48a4520b02_face-video-get.png)
You will first get this response:
![https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd412e28f5186fdd8569_face-video-process.png](https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd412e28f5186fdd8569_face-video-process.png)
Once the request is done (status : finished), you will be able to get the result with this print:
![https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd4aabbe59824a7ae178_face-video-get-result.png](https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd4aabbe59824a7ae178_face-video-get-result.png)
Here is an example of a result for Video Face Detection task:
![https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd8cec7ef6bce5eb088c_face-video-get-response.png](https://uploads-ssl.webflow.com/61e7d259b7746e3f63f0b6be/6346bd8cec7ef6bce5eb088c_face-video-get-response.png)
## **Benefits of using Video Face Detection API with Eden AI**
Using Video Face Detection with Eden AI API is quick and easy.
### Save time and cost

We offer a unified API for all providers: simple and standard to use, with a quick switch between providers and an access to the specificic features of each provider

### Easy to integrate

The JSON output format is the same for all suppliers thanks to Eden AI's standardisation work. The response elements are also standardised thanks to Eden AI's powerful matching algorithms.

### Customization

With Eden AI you have the possibility to integrate a third party platform: we can quickly develop connectors. To go further and customize your Video Face Detection request with specific parameters, check out our [documentation](https://docs.edenai.co/reference/video_face_detection_async_create?referral=how-to-video-face-detection-python).

**[Create your Account on Eden AI](https://app.edenai.run/user/register?referral=how-to-video-face-detection-python)**