Skip to main content
Use face detection for UGC moderation, testimonials, and privacy-safe previews. Region params hide explicit coordinates when you already know what to obscure.
Face blur before and after
Face-aware crop on a portrait
Detected face bounding boxes
Pixelated image
Image with a blurred rectangular region

Face blur and pixelation

ParamValueDefault
blurFacesBlur detected faces. Accepts 1, true, yes, or on.false
faceBlurBlur strength (1-100).32
faceBlurShapeMask shape: round (oval) or square.round
pixelateFacesPixelate detected faces instead of blurring.false
facePixelatePixel block size (2-100).16
?w=900&blurFaces=1
?w=900&blurFaces=true&faceBlur=48
?w=900&pixelateFaces=1&facePixelate=24
Face privacy runs after resize/crop/text overlay and before final encoding, so detected boxes line up with the delivered image. Face detection is best-effort — review sensitive workflows manually. For crop behaviour centred on faces (gravity=face), see Resize, crop & fit and the deeper Smart cropping guide.

Region privacy

Use output-pixel coordinates when you already know what should be hidden:
ParamValue
blurRegionBlur explicit x,y,w,h region.
pixelateRegionPixelate explicit region. Optional regionPixelate amount.
plateRegionAlias for blurring a license-plate region.
regionsPipe-separated list: blur:x,y,w,h:amount, pixelate:…, plate:….
?w=900&blurRegion=120,320,220,80
?w=900&pixelateRegion=120,320,220,80&regionPixelate=18
?w=900&regions=plate:120,320,220,80:44|blur:40,40,160,120:28
Automatic license-plate detection is planned as a separate ML feature; coordinate-based plate privacy is reliable today.