Image blur

POST /api/image-blur

Apply a Gaussian blur to an image. Configurable sigma controls the strength. Common uses: backgrounds, privacy redaction, soft-focus effects.

Applies a Gaussian blur to an image. The `sigma` parameter controls strength: small values (0.5–1) lightly soften noise; mid values (3–8) produce visible blur; large values (20+) approach mosaic-like featurelessness. Common uses: - Backgrounds for layered designs. - Privacy-style redaction (though for faces specifically, see `image-privacy-blur-faces`). - Soft-focus / dreamy effects.

Inputs

Name	Type	Default	Description
image*	file	—	Input image.
radius	number (0…50)	0	Kernel radius hint (0 = automatic).
sigma	number (0.1…50)	2	Gaussian standard deviation.
format	enum (png \| jpeg \| webp)	—	Output format.

Response

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

Code samples

Built from the soft-blur example.

# Download or substitute the example input:
#   curl -O https://xtract.bot/examples/image-png-to-webp/sample.png
IMAGE=$(base64 -w0 < sample.png)

curl -X POST https://api.xtract.bot/api/image-blur \
  -H "Content-Type: application/json" \
  -H "Accept: application/octet-stream" \
  -H "X-Account-Id: $XTRACT_ACCOUNT_ID" \
  -H "X-Api-Key: $XTRACT_API_KEY" \
  -d '{
  "radius": 0,
  "sigma": 2,
  "image": "'"$IMAGE"'"
}'