Blur a face in an image

Simply upload any image of a person and we will automatically detect and blur the region around their face. This is done by using the blur_regions parameter from the 🤖/image/resize Robot, which lets you specify multiple ellipses to blur in the image.

By combining this with the power of 🤖/script/run, we are able to position a blurred ellipse directly in the middle of the detected face, using co-ordinates generated by 🤖/image/facedetect.

Step 1:

Handle uploads

We can handle uploads of your users directly.Learn more

man-standing-on-balcony.jpg

Image – 98 KB

583 × 800

":original": {
  "robot": "/upload/handle"
}

/upload/handle

This bot receives uploads that your users throw at you from browser or apps, or that you throw at us programmatically

Step 2:

Detect faces in images

We offer Artificial Intelligence as a service, so you don't have to run your own AI models or install complicated software.Learn more

man-standing-on-balcony.jpg

Image – 98 KB

583 × 800

"faces_detected": {
  "use": ":original",
  "robot": "/image/facedetect",
  "result": true,
  "faces": "max-confidence",
  "format": "preserve"
}

/image/facedetect

This bot detects faces in images and can return either their coordinates or the faces themselves as new images

Step 3:

Convert, resize, or watermark images

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more.Learn more

man-standing-on-balcony.jpg

Image – 92 KB

583 × 800

"blur_faces": {
  "use": "faces_detected",
  "robot": "/image/resize",
  "blur": "0x10",
  "blur_regions": [
    {
      "x": "${file.meta.faces[0].x1 + (file.meta.faces[0].width / 2)}",
      "y": "${file.meta.faces[0].y1 + (file.meta.faces[0].height / 2)}",
      "width": "${file.meta.faces[0].width}",
      "height": "${file.meta.faces[0].height}"
    }
  ],
  "format": "jpg"
}

/image/resize

This bot resizes, crops, changes colorization, rotation, and applies text and watermarks to images

Step 4:

Export files to Amazon S3

We export to the storage platform of your choice.Learn more

:original

https://demos.transloadit.com/19/65f8da06f348c8b0a955e3fd77bf8e/man-standing-on-balcony.jpg

faces_detected

https://demos.transloadit.com/f7/2affb236564463926dffb04707b19f/man-standing-on-balcony.jpg

blur_faces

https://demos.transloadit.com/85/ce050e79f0434eb17854745f1de1e2/man-standing-on-balcony.jpg

"exported": {
  "use": [
    "faces_detected",
    "blur_faces",
    ":original"
  ],
  "robot": "/s3/store",
  "credentials": "demo_s3_credentials",
  "url_prefix": "https://demos.transloadit.com/"
}

/s3/store

This bot exports encoding results to Amazon S3

Live Demo. See for yourself

Loading Uppy demo…

This live demo is powered by Uppy, our open source file uploader that you can also use without Transloadit, and tus, our open protocol for resumable file uploads that is making uploading more reliable across the world.

Build this in your own language

<!-- This pulls Uppy from our CDN -->
<!-- For smaller self-hosted bundles, install Uppy and plugins manually: -->
<!-- npm i --save @uppy/core @uppy/dashboard @uppy/remote-sources @uppy/transloadit ... -->
<link
  href="https://releases.transloadit.com/uppy/v3.10.0/uppy.min.css"
  rel="stylesheet"
/>
<button id="browse">Select Files</button>
<script type="module">
  import {
    Uppy,
    Dashboard,
    ImageEditor,
    RemoteSources,
    Transloadit,
  } from 'https://releases.transloadit.com/uppy/v3.10.0/uppy.min.mjs'
  const uppy = new Uppy()
    .use(Transloadit, {
      waitForEncoding: true,
      alwaysRunAssembly: true,
      assemblyOptions: {
        params: {
          // It's often better store encoding instructions in your account
          // and use a `template_id` instead of adding these steps inline
          steps: {
            ':original': {
              robot: '/upload/handle',
            },
            faces_detected: {
              use: ':original',
              robot: '/image/facedetect',
              result: true,
              faces: 'max-confidence',
              format: 'preserve',
            },
            blur_faces: {
              use: 'faces_detected',
              robot: '/image/resize',
              blur: '0x10',
              blur_regions: [
                {
                  x: '${file.meta.faces[0].x1 + (file.meta.faces[0].width / 2)}',
                  y: '${file.meta.faces[0].y1 + (file.meta.faces[0].height / 2)}',
                  width: '${file.meta.faces[0].width}',
                  height: '${file.meta.faces[0].height}',
                }, 
              ],
              format: 'jpg',
            },
            exported: {
              use: ['faces_detected', 'blur_faces', ':original'],
              robot: '/s3/store',
              credentials: 'demo_s3_credentials',
              url_prefix: 'https://demos.transloadit.com/',
            },
          },
        },
      },
    })
    .use(Dashboard, { trigger: '#browse' })
    .use(ImageEditor, { target: Dashboard })
    .use(RemoteSources, {
      companionUrl: 'https://api2.transloadit.com/companion',
    })
    .on('complete', ({ transloadit }) => {
      // Due to `waitForEncoding:true` this is fired after encoding is done.
      // Alternatively, set `waitForEncoding` to `false` and provide a `notify_url`
      console.log(transloadit) // Array of Assembly Statuses
      for (const assembly of transloadit) {
        console.log(assembly.results) // Array of all encoding results
      }
    })
    .on('error', (error) => {
      console.error(error)
    })
</script>

Read docs: Browsers

So many ways to integrate

Transloadit is a service for companies with developers. And there are many ways developers can put Transloadit to good use inside your company to automate media processing.