Skip to content
Default Uploader Docs
Account

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 ratio
https://api.defaultuploader.com/v1/image/upload/token/sample.jpg?w=100

width

alias: w

Creates an image with the specified width while maintaining the correct aspect ratio.

min 0, max 5000
Width
w=100
Width
w=200
Width
w=300

height

alias: h

Creates an image with the specified height while maintaining the correct aspect ratio.

min 0, max 5000
Example image with parameters
h=100
Example image with parameters
h=200
Example image with parameters
h=300

format

alias: f

Changes the image format.

Supported formats
JPEG, PNG, WebP, AVIF, TIFF, GIF, SVG, HEIC

auto Coming soon

Automatic detection of modern image format support by the browser.

quality

alias: q 
min 0, max 100, default value = 75

Change the image quality.

Example image with parameters
q=100
Example image with parameters
q=1

dpr


1, 2 — default 1

Supports high-resolution screens, doubling the image size.

Example image with parameters
w=100&dpr=1
Example image with parameters
w=100&dpr=2

animated

alias: a 
animated=0

Disable animation for GIF or WebP.

Example image with parameters
animated=0
Example image with parameters

fit

How the image should be resized/cropped to fit the target size(s).

cover, contain, fill, inside, outside
Example image with parameters
h=200&w=500&fit=contain
Example image with parameters
h=200&w=500&fit=cover
Example image with parameters
h=200&w=500&fit=fill
Example image with parameters
h=200&w=500&fit=inside
Example image with parameters
h=200&w=500&fit=outside

func

Smart crop. Uses AI to find the “interesting” part of the image or a face and centers it in the crop.

face, auto
Example image with parameters
h=500&w=500&func=face
Example image with parameters
h=500&w=500

zoom

alias: z

Optional parameter for “smart” cropping. Adjusts the margins.

min 0.1, max 1
0.1 - is 10% of the image's side
Example image with parameters
h=600&w=600&func=face&zoom=1
Example image with parameters
h=600&w=600&func=face&zoom=0.3

blur

Creates a blurred image

min 0.3, max 1000
Example image with parameters
blur=10

negate

Creates a “negative” image

?negate
Example image with parameters
negate

normalize_lower

Enhances the contrast of the output image by stretching its brightness to cover the full dynamic range

min 1, max 99
Example image with parameters
normalize_lower=65

normalize_upper

Enhances the contrast of the output image by stretching its brightness to cover the full dynamic range

min 1, max 99
Example image with parameters
normalize_upper=95

saturation

Sets the image saturation

min 0.1
Example image with parameters
saturation=0.1
Example image with parameters
saturation=1.5

brightness

Sets the image brightness

min 0.1
Example image with parameters
brightness=0.1
Example image with parameters
brightness=1.5

hue

Sets the image hue

min 1
Example image with parameters
hue=25

lightness

Sets the image lightness

min 0.1
Example image with parameters
lightness=30

greyscale

Converts the image to black and white

?greyscale
Example image with parameters
greyscale

radius

Rounds the corners of the image

min 0 max 100
Example image with parameters
rs=5

To create a circular image, set equal dimensions.

Example image with parameters
rs=50&w=400&h=400

remove_background

alias: rm_bg

Removes the background from the image

?rm_bg
Example image with parameters
rm_bg
Example image with parameters
rm_bg&func=face&z=0.3&rs=50

super_resolution coming soon

Uses AI to upscale the image resolution.