Image resizing

Add parameters to the URL of an image on edge or vault and binedge returns a resized copy. Every parameter is part of the signature, so only your server can create new sizes.

Parameters

Parameter	Values	Default
w	Target width, 1 to 4096	No limit
h	Target height, 1 to 4096	No limit
fit	inside scales the image to fit in the box; cover fills the box and crops the rest, and needs both w and h	inside
crop	center or smart (crops around the most interesting area); only with fit=cover	center
fmt	auto, jpeg, png, webp or avif	auto
q	Quality, 1 to 100; not used for png	jpeg 80, webp 75, avif 50

• Give at least one of w and h. Images are never enlarged: a smaller original is returned at its own size.
• The image is rotated according to its EXIF orientation, and EXIF, XMP, IPTC and ICC metadata are removed.
• fmt=auto returns AVIF when the browser accepts it, otherwise WebP when accepted, otherwise PNG for images with transparency and JPEG for the rest. The response carries Vary: Accept.
• Originals larger than 64 MiB or about 268 million pixels, files that are not images, unknown parameters and values out of range return 422.

Example

https://k3x9q2m7.edge.binedge.net/production/groups/logo.png?crop=smart&fit=cover&fmt=webp&h=144&q=75&w=144&sig=410RAzVg42KRbH5gEBlzbrYq5d7w-5avYm4J2EA9kro

The string to sign for this URL is shown in Signed URLs. With Laravel:

Storage::disk('binedge')->imageUrl('groups/logo.png', ['w' => 144, 'h' => 144, 'fit' => 'cover', 'crop' => 'smart', 'fmt' => 'webp', 'q' => 75]);

Caching

• On edge, each resized image is cached for a year under its full URL. When the original changes, upload it under a new key.
• On vault, add exp as for any private file. Resized private images are not cached.