The /image/facedetect Robot

Our /image/facedetect robot

Transloadit offers computer vision as a service, so you don't have to run your own AI models or install complicated software.

The /image/facedetect Robot detects faces in images and returns their coordinates, or cuts them from the original images and returns those as new images.

The /image/facedetect Robot's Parameters

Name Type Default Description
crop Boolean false Determine if the detected faces should be extracted. If this option is set to false, then the Robot returns the input image again, but with the coordinates of all detected faces attached to file.meta.faces in the result JSON. If this parameter is set to true, the Robot will output all detected faces as images.
crop_padding String "5px" Specifies how much padding is added to the extracted face images if crop is set to true. Values can be in px (pixels) or % (percentage of the width and height of the particular face image).
format String "preserve" Determines the output format of the extracted face images if crop is set to true. The default value "preserve" means that the input image format is re-used. Valid values are "jpg", "png", "tiff" and "preserve".

Example use cases featuring the /image/facedetect robot

See the robot in action with some live demos and code samples right here on our website:

Automatically detect faces in images

Here you can see a quick example of the Assembly Instructions required to create this encoding pipeline. More information is available in the Live demo

 "steps": {
    "thumb": {
      "use": ":original",
      "robot": "/image/facedetect",
      "crop": true,
      "format": "preserve",
      "crop_padding": "10%"

Did you know?

You can easily combine Robots to create powerful workflows, unique to your business.

This is the power of Transloadit.