brightness

The brightness transformation adjusts the overall brightness of an image by applying a multiplier factor. Use values greater than 1 to brighten, values less than 1 to darken. Useful for correcting exposure, enhancing dark photos, or creating variations for different lighting conditions.

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/brightness:value=1.2/ASSET_ID.jpg

Examples

Increase Brightness (1.2x)

curl -i GET https://media.vyso.io/brightness:value=1.2/ASSET_ID.jpg

Significant Brightness Increase (1.5x)

curl -i GET https://media.vyso.io/brightness:value=1.5/ASSET_ID.jpg

Decrease Brightness (0.8x)

curl -i GET https://media.vyso.io/brightness:value=0.8/ASSET_ID.jpg

Dark Image (0.5x)

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

Original Brightness (No Change)

curl -i GET https://media.vyso.io/brightness:value=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

valueREQUIRED

Brightness multiplier factor. Use this to increase or decrease image brightness. Accepted values:

  • 0.5 - Half brightness (darker)
  • 0.8 - Slightly darker
  • 1.0 - Original brightness (no change)
  • 1.2 - Slightly brighter
  • 1.5 - Significantly brighter
  • 2.0 - Double brightness
  • Decimal values are supported for fine-tuned brightness control
  • Values should be positive; extreme values may cause image clipping

Response

The API returns the image with the brightness adjusted by the specified multiplier factor. 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