edge

The edge transformation detects and emphasizes edges in an image using edge detection algorithms. Creates a sketch-like or outlined appearance. Perfect for artistic effects, technical analysis, or creating outlines of objects in images.

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/edge:sigma=AMOUNT/ASSET_ID.jpg

Examples

Standard Edge Detection

curl -i GET https://media.vyso.io/edge/ASSET_ID.jpg

Edge Detection with Sigma 1

curl -i GET https://media.vyso.io/edge:sigma=1/ASSET_ID.jpg

Edge Detection with Sigma 2

curl -i GET https://media.vyso.io/edge:sigma=2/ASSET_ID.jpg

Strong Edge Detection

curl -i GET https://media.vyso.io/edge:sigma=3/ASSET_ID.jpg

Very Strong Edge Detection

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

sigmaOPTIONAL

Edge detection sensitivity or kernel size. Accepted values:

  • Range: 0.5 to 10.0
  • 1.0 - Standard edge detection (default)
  • 0.5-1.0 - Fine, detailed edges
  • 2.0-5.0 - Stronger edge emphasis

Response

The API returns an edge-detected version of the image with emphasized boundaries and outlines. 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