How to crop an image to the face in Python

In two easy steps, we will learn how to use an API to crop to the face in an image.

First, install the API using pip installer, like so:

pip install git+https://github.com/Cloudmersive/Cloudmersive.APIClient.Python.ImageRecognition.git

Next we have a choice between a round or square crop by calling face_crop_first_round or face_crop_first, respectively. In this example we will be using round cropping:

from __future__ import print_function
import time
import cloudmersive_image_api_client
from cloudmersive_image_api_client.rest import ApiException
from pprint import pprint
# Configure API key authorization: Apikey
configuration = cloudmersive_image_api_client.Configuration()
configuration.api_key['Apikey'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Apikey'] = 'Bearer'
# create an instance of the API class
api_instance = cloudmersive_image_api_client.FaceApi(cloudmersive_image_api_client.ApiClient(configuration))
image_file = '/path/to/file' # file | Image file to perform the operation on.  Common file formats such as PNG, JPEG are supported.
try:
    # Crop image to face (round)
    api_response = api_instance.face_crop_first_round(image_file)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling FaceApi->face_crop_first_round: %s\n" % e)

And it’s really that easy! Here is a quick example:

And the resulting cropped image: