The /image/facedetect Robot

We offer 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.


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".

Live demos

Our /image/facedetect Robot can be used in combination with other Robots, to create powerful workflows unique to your use case.
Here are a few example scenarios, and the required Assembly Instructions to implement them.
You can also try demos of these examples right here, live on our website.

Automatically detect faces in images

  "steps": {
    ":original": {
      "robot": "/upload/handle"
    "faces_detected": {
      "use": [":original"],
      "robot": "/image/facedetect",
      "crop": true,
      "crop_padding": "10%",
      "format": "preserve"
    "exported": {
      "use": ["faces_detected", ":original"],
      "robot": "/s3/store",
      "credentials": "demo_s3_credentials"

Blog posts about our /image/facedetect Robot

Over the years, we wrote the following posts about our /image/facedetect Robot on our blog:

Did you know?

You can easily combine Robots to create powerful workflows, unique to your business.
This is the power of Transloadit.