Blur faces (privacy)

POST /api/image-privacy-blur-faces

Auto-blur every face detected in a photo. Useful for publishing crowd / street photos without identifying individuals; configurable blur strength.

Detects every face in an image and applies a Gaussian blur over each face's bounding rectangle. The rest of the image is untouched. Useful for publishing crowd or street photos without identifying individuals, blurring bystanders in editorial shots, etc. `blurStrength` (default 25) controls how heavy the blur is — typical privacy use wants ≥20 to ensure features are unrecognisable.

Inputs

Name	Type	Default	Description
image*	file	—	Input image bytes.
method	enum (gaussian \| pixelate)	"gaussian"	Blur algorithm.
strength	number (1…201)	35	Gaussian kernel size (odd) or pixelate cell size.
padding	number (0…2)	0.15	Expand each face box by this fraction of its size.
scoreThreshold	number (0…1)	0.6	Face detection confidence cutoff.
format	enum (jpeg \| png)	"jpeg"	Output encoding.
quality	number (1…100)	90	JPEG quality (ignored for PNG).

Response

Modes: binary, json. Cache: yes (24h TTL).