How to crop an image to the face in Ruby

Today we will use our image recognition API to quickly crop images to the person’s face. The first thing to do is add this snippet to your Gemfile so that we can access our API client.

gem 'cloudmersive-image-recognition-api-client', '~> 1.3.2'

Now you have the option of calling face_crop_first for a square image or face_crop_first_round for a round crop. The below example uses face_crop_first

# load the gem
require 'cloudmersive-image-recognition-api-client'
# setup authorization
CloudmersiveImageRecognitionApiClient.configure do |config|
  # Configure API key authorization: Apikey
  config.api_key['Apikey'] = 'YOUR API KEY'
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
  #config.api_key_prefix['Apikey'] = 'Bearer'
end
api_instance = CloudmersiveImageRecognitionApiClient::FaceApi.new
image_file = File.new("/path/to/file") # File | Image file to perform the operation on.  Common file formats such as PNG, JPEG are supported.
begin
  #Crop image to face (square)
  result = api_instance.face_crop_first(image_file)
  p result
rescue CloudmersiveImageRecognitionApiClient::ApiError => e
  puts "Exception when calling FaceApi->face_crop_first: #{e}"
end

Here is an example image:

And the resulting cropped image:

Super easy right?