Images
To transform an image, you need to make a request with parameters. The service will create a new file, return it in response to the request, and save it to your storage.
For subsequent requests with the same parameters, the already created file will be returned.
Example:
// create a new image with a width of 100px while maintaining the aspect ratiohttps://api.defaultuploader.com/v1/image/upload/token/sample.jpg?w=100Creates an image with the specified width while maintaining the correct aspect ratio.
min 0, max 5000height
Section titled “height”Creates an image with the specified height while maintaining the correct aspect ratio.
min 0, max 5000format
Section titled “format”Changes the image format.
Supported formatsJPEG, PNG, WebP, AVIF, TIFF, GIF, SVG, HEIC
autoComing soonAutomatic detection of modern image format support by the browser.
quality
Section titled “quality”min 0, max 100, default value = 75Change the image quality.
1, 2 — default 1Supports high-resolution screens, doubling the image size.
animated
Section titled “animated”animated=0Disable animation for GIF or WebP.
How the image should be resized/cropped to fit the target size(s).
cover, contain, fill, inside, outsideSmart crop. Uses AI to find the “interesting” part of the image or a face and centers it in the crop.
face, autoOptional parameter for “smart” cropping. Adjusts the margins.
min 1, max 10, step 0.1Creates a blurred image
min 0.3, max 1000negate
Section titled “negate”Creates a “negative” image
?negatenormalize_lower
Section titled “normalize_lower”Enhances the contrast of the output image by stretching its brightness to cover the full dynamic range
min 1, max 99normalize_upper
Section titled “normalize_upper”Enhances the contrast of the output image by stretching its brightness to cover the full dynamic range
min 1, max 99saturation
Section titled “saturation”Sets the image saturation
min 0.1brightness
Section titled “brightness”Sets the image brightness
min 0.1Sets the image hue
min 1lightness
Section titled “lightness”Sets the image lightness
min 0.1greyscale
Section titled “greyscale”Converts the image to black and white
?greyscaleradius
Section titled “radius”Rounds the corners of the image
min 0 max 100To create a circular image, set equal dimensions.
remove_background
Section titled “remove_background”Removes the background from the image
?rm_bgsuper_resolution coming soon
Section titled “super_resolution ”Uses AI to upscale the image resolution.