Gaussian Blur
Apply Gaussian blur to an image with adjustable radius
GET
10 credits
/v1/image/filter/blur
curl "https://image.toolkitapi.io/v1/image/filter/blur?url=https://toolkitapi.io/static/samples/sample-image.png&radius=5.0&format=jpeg"
import httpx
resp = httpx.get(
"https://image.toolkitapi.io/v1/image/filter/blur?url=https://toolkitapi.io/static/samples/sample-image.png&radius=5.0&format=jpeg",
)
print(resp.json())const resp = await fetch("https://image.toolkitapi.io/v1/image/filter/blur?url=https://toolkitapi.io/static/samples/sample-image.png&radius=5.0&format=jpeg", {
});
const data = await resp.json();
console.log(data);# See curl example
Response
200 OK
{
"image": "/9j/4AAQSkZJRgABAQ...(base64 data)...",
"format": "jpeg",
"radius": 5.0
}Try It Live
Live Demo
Response
Description
Apply Gaussian blur to an image with adjustable radius
How to Use
1
1. Provide the source image via the `url` query parameter.
2
2. Set the `radius` parameter to control blur intensity.
3
3. Choose your preferred output `format` (png, jpeg, or webp) and `quality` level.
About This Tool
Use the Gaussian Blur endpoint to apply a smooth blur effect to any image. The blur radius is fully configurable from 0.1 (subtle softening) to 50.0 pixels (heavy blur).
Gaussian blur is ideal for creating background effects, reducing noise, privacy masking, and artistic bokeh-style looks. The algorithm applies a true Gaussian kernel for natural-looking results.
Why Use This Tool
- Privacy masking — Blur faces or sensitive information in screenshots
- Background effects — Create depth-of-field bokeh effects for product photos
- Noise reduction — Smooth out grainy images from low-light photography
- UI backgrounds — Generate blurred hero images for text overlay sections
Frequently Asked Questions
What radius should I use?
A radius of 1–3 gives a subtle softening effect. Use 5–10 for noticeable blur, and 20+ for heavy privacy masking or bokeh backgrounds.
Does blur work on transparent images?
Yes, blur is applied to all channels including alpha. Edges of transparent regions may blend with surrounding pixels.
Can I blur only part of an image?
This endpoint blurs the entire image. To blur a specific region, crop the area first, blur it, then composite it back onto the original.
Start using Gaussian Blur now
Get your free API key and make your first request in under a minute.