​

How to use

The blur transformation allows you to apply a Gaussian blur effect to an image.

Pass the following query param to the API endpoint:

blur=sigma

Where:

• sigma is the standard deviation of the Gaussian distribution. It controls the amount of blur.

For example: blur=10

​

Parameter

sigma: The standard deviation of the Gaussian distribution. This parameter accepts positive float values:

• Lower values result in a subtle blur effect.
• Higher values produce a stronger, more pronounced blur.
• A value of 0 leaves the image unchanged.

​

Effect of Blur

• Smooths out the image, reducing detail and noise.
• Creates a soft, out-of-focus effect.
• Can be used to reduce image noise or create a dreamy, ethereal look.

This transformation is useful for various purposes, such as creating background images, softening imperfections, or achieving certain artistic effects.

​

Original Image

​

Image with Slight Blur

​

Image with Strong Blur

​

Best Practices

• Start with low sigma values (e.g., 1-10) for subtle blur effects.
• Use higher sigma values (e.g., 20-70) for more dramatic blurring.
• Be cautious with very high sigma values, as they can significantly reduce image detail.
• When creating background images, consider combining blur with other transformations like brightness or saturation adjustments.
• For portraits or product photos, a slight blur can help soften imperfections while maintaining overall image clarity.
• Remember that blurring can affect the file size of the image, potentially making it larger due to the loss of sharp edges.

​

Note

The visual effect of the blur can vary depending on the size and content of the original image. Larger images may require higher sigma values to achieve a noticeable blur effect. It’s often helpful to experiment with different values to achieve the desired result.