blur

The blur transformation applies a Gaussian blur effect to an image with configurable intensity. The blur strength is automatically adjusted based on image size for consistent perceptual effect across different resolutions. Perfect for creating depth-of-field effects, smoothing images, or privacy masking.

Serving Content via CDN

The Media API is a CDN-based service that serves transformed images via GET requests. When you request a transformed image URL, the transformation is applied dynamically on the first request and then cached for subsequent requests.

URL Pattern

https://media.vyso.io/blur:value=2/ASSET_ID.jpg

Examples

Mild Blur

curl -i GET https://media.vyso.io/blur:value=1/ASSET_ID.jpg

Standard Blur

curl -i GET https://media.vyso.io/blur:value=2.5/ASSET_ID.jpg

Strong Blur

curl -i GET https://media.vyso.io/blur:value=5/ASSET_ID.jpg

Extremely Strong Blur

curl -i GET https://media.vyso.io/blur:value=8/ASSET_ID.jpg

Very Subtle Blur

curl -i GET https://media.vyso.io/blur:value=0.5/ASSET_ID.jpg

On the first request, you'll receive a X-Cache: MISS header while the transformation is applied and cached. Subsequent requests will return X-Cache: HIT.

Parameters

valueREQUIRED

Blurring intensity. The blur strength is size-aware and will appear consistent regardless of image dimensions. Accepted values:

  • 0 - No blur applied
  • 0.1-0.9 - Very mild blur effect
  • 1 - Standard mild blur (recommended)
  • 2-5 - Progressively stronger blur
  • 6-10 - Extremely strong blur
  • Decimal values are supported for fine-tuning intensity

Response

The API returns the blurred image with the specified blur intensity applied. The blur effect is automatically scaled based on image dimensions for consistent visual appearance. The response format depends on the format of the asset stored in the Vyso asset cloud.

Content-Type: Determined by the stored asset format (e.g., image/jpeg, image/png)

← Back to Transformations