equalize

The equalize transformation performs histogram equalization to enhance contrast and detail in images. It redistributes pixel intensities across the full tonal range, improving visibility in low-contrast photographs.

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/equalize:clip=CLIP/ASSET_ID.jpg

Examples

Standard Histogram Equalization

curl -i GET https://media.vyso.io/equalize/ASSET_ID.jpg

Equalize with 90% Clipping

curl -i GET https://media.vyso.io/equalize:clip=0.9/ASSET_ID.jpg

Moderate Clipping (50%)

curl -i GET https://media.vyso.io/equalize:clip=0.5/ASSET_ID.jpg

Minimal Clipping

curl -i GET https://media.vyso.io/equalize:clip=0.1/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

clipOPTIONAL

Histogram clipping limit. Accepted values:

  • Range: 0.0 to 1.0
  • 0.0 - Standard histogram equalization (default)
  • 0.1 - Minimal clipping, more aggressive enhancement
  • 0.5 - Moderate clipping
  • 0.9 - Significant clipping, gentler enhancement
  • Higher values reduce over-enhancement and preserve natural appearance

Response

The API returns the image with histogram equalization applied. 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