exposure

The exposure transformation adjusts the overall brightness exposure of an image, simulating camera exposure adjustment. Increase exposure to brighten underexposed photos or decrease it to recover blown-out highlights. Perfect for correcting exposure issues in photography.

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/exposure:value=EV/ASSET_ID.jpg

Examples

Reduce Exposure (Darker)

curl -i GET https://media.vyso.io/exposure:value=-1.0/ASSET_ID.jpg

Slight Underexposure

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

Normal Exposure

curl -i GET https://media.vyso.io/exposure:value=0.0/ASSET_ID.jpg

Slight Overexposure (Brighter)

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

Increase Exposure (Much Brighter)

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

Exposure adjustment in stops (EV). Accepted values:

  • Range: -5.0 to 5.0
  • 0.0 - No adjustment (default)
  • Negative values (e.g., -1.0) - Reduce exposure (darken)
  • Positive values (e.g., 1.0) - Increase exposure (brighten)
  • Decimal values are supported for fine-tuned adjustments

Response

The API returns an image with the specified exposure adjustment applied. Higher values make the image brighter, while lower values darken it. 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