vignette

The vignette transformation darkens the edges of an image while keeping the center bright, creating a natural spotlight or framing effect. Perfect for drawing attention to the center of an image, creating artistic portraits, or simulating classic camera lens effects.

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/vignette:strength=AMOUNT/ASSET_ID.jpg

Examples

Subtle Vignette

curl -i GET https://media.vyso.io/vignette:strength=0.3/ASSET_ID.jpg

Moderate Vignette

curl -i GET https://media.vyso.io/vignette:strength=0.6/ASSET_ID.jpg

Strong Vignette

curl -i GET https://media.vyso.io/vignette:strength=1.0/ASSET_ID.jpg

Dramatic Vignette

curl -i GET https://media.vyso.io/vignette:strength=1.5/ASSET_ID.jpg

Extreme Vignette (Spotlight)

curl -i GET https://media.vyso.io/vignette:strength=2.0/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

strengthOPTIONAL

Vignette strength or intensity. Accepted values:

  • Range: 0.0 to 3.0+
  • 0.0 - No vignette effect
  • 0.3-0.5 - Subtle edge darkening
  • 1.0 - Standard vignette (default)
  • 1.5-2.0 - Dramatic spotlight effect

Response

The API returns an image with darkened edges and a bright center, creating a natural vignette effect. 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