- Media API
- Transformations
- Adjust
- sharpen
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.jpgExamples
Subtle Sharpening
curl -i GET https://media.vyso.io/sharpen:value=0.5/ASSET_ID.jpgModerate Sharpening
curl -i GET https://media.vyso.io/sharpen:value=1.0/ASSET_ID.jpgStrong Sharpening
curl -i GET https://media.vyso.io/sharpen:value=2.0/ASSET_ID.jpgVery Strong Sharpening
curl -i GET https://media.vyso.io/sharpen:value=3.0/ASSET_ID.jpgExtreme Sharpening (Use with Caution)
curl -i GET https://media.vyso.io/sharpen:value=4.0/ASSET_ID.jpgOn 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
valueREQUIREDThe sharpening intensity factor. Accepted values:
- Range: 0.0 to 5.0+
0.0- No sharpening0.5- Subtle sharpening (recommended for most use cases)1.0- Moderate sharpening2.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)