sharpen

The sharpen transformation enhances the clarity and definition of edges in an image. Apply sharpening to make details pop and improve overall image clarity, particularly useful for product photography, thumbnails, or images that appear soft. Use carefully to avoid over-sharpening artifacts.

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/sharpen:value=AMOUNT/ASSET_ID.jpg

Examples

Subtle Sharpening

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

Moderate Sharpening

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

Strong Sharpening

curl -i GET https://media.vyso.io/sharpen:value=2.0/ASSET_ID.jpg

Very Strong Sharpening

curl -i GET https://media.vyso.io/sharpen:value=3.0/ASSET_ID.jpg

Extreme Sharpening (Use with Caution)

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

valueREQUIRED

The sharpening intensity factor. Accepted values:

  • Range: 0.0 to 5.0+
  • 0.0 - No sharpening
  • 0.5 - Subtle sharpening (recommended for most use cases)
  • 1.0 - Moderate sharpening
  • 2.0+ - Strong sharpening (may cause artifacts)
  • Decimal values are supported for fine-tuned adjustments

Response

The API returns a sharpened version of the image with enhanced edge definition and clarity. Higher values increase the sharpening effect but may introduce artifacts or halos around edges. 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)