Detect and Find Faces in an Image in Python

If you’re ever making changes to a photo without opening it, it’s good to know if & where human faces are in the image ahead of time. Thankfully, there’s an API for that — using the /image/face/locate iteration of the Cloudmersive Image API, you can detect & locate the positions of all faces in an image and return their coordinates. This API uses Machine Learning to recognize and process the image. Below, we’ll walk through how to connect in Python using code from the Cloudmersive API console.

To start connecting, first run the below command & install the SDK:

pip install cloudmersive-image-api-client

After that, copy & paste the below code snippets. Make sure to include your API key where indicated (if you don’t have an API key, you can make one easily for free on the Cloudmersive website).

from __future__ import print_function
import time
import cloudmersive_image_api_client
from import ApiException
from pprint import pprint
# Configure API key authorization: Apikey
configuration = cloudmersive_image_api_client.Configuration()
configuration.api_key['Apikey'] = 'YOUR_API_KEY'

Finally, you can wrap up the function with the below code:

# create an instance of the API class
api_instance = cloudmersive_image_api_client.FaceApi(cloudmersive_image_api_client.ApiClient(configuration))
image_file = '/path/to/inputfile' # file | Image file to perform the operation on. Common file formats such as PNG, JPEG are supported.
# Detect and find faces in an image
api_response = api_instance.face_locate(image_file)
except ApiException as e:
print("Exception when calling FaceApi->face_locate: %s\n" % e)



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store


There’s an API for that. Cloudmersive is a leader in Highly Scalable Cloud APIs.