Skymage Documentation

Skymage transforms public or externally stored images through cacheable URL parameters.

First Request

https://demo.skymage.net/v1/daudau.cc/images/crab.png?w=800&f=webp&q=82

The URL contains:

• demo: the pull-zone handle.
• daudau.cc/images/crab.png: the public source hostname and path.
• w=800&f=webp&q=82: transformation parameters.

Use the API playground to build and preview URLs, or open the generated API reference for the complete parameter contract.

Request Patterns

Public origin:

https://{handle}.skymage.net/v1/{origin-host}/{path}?{parameters}

Configured external storage:

https://{handle}.skymage.net/v1/ex/{storage-handle}/{path}?{parameters}

Core Capabilities

• Resize by width, height, fit mode, and device pixel ratio.
• Convert output to JPEG, PNG, WebP, or AVIF.
• Crop by position, focal percentage, entropy, attention, or explicit coordinates.
• Apply rotation, flipping, blur, sharpening, brightness, contrast, gamma, and color filters.
• Add backgrounds, shape masks, trimming, letterboxing, and text watermarks.
• Read images from public HTTPS origins, Amazon S3, and Bunny Storage.

Output And Caching

Transformed images are returned with long-lived immutable cache headers. Every transformation parameter is part of the CDN cache key, so identical URLs reuse the same edge-cached result.

Use explicit dimensions and formats in production. A stable URL gives browsers and the CDN a stable artifact to cache.

Next Steps

• Using Skymage
• Image API reference
• Image API playground
• External storage