Cloudimage - Documentation

Accounts created before Nov. 1st, 2021

Accounts created before November 1, 2021 have to include /v7/ in the path, like shown below.

//token.cloudimg.io/v7/original_image_url?operations&filters

Accounts created on or after November 1, 2021 do not require /v7/ and documentation have been updated accordingly.
To verify the type of configuration on your Cloudimage account, log in to your Cloudimage admin panel and look at the syntax provided on the Welcome page.

[NOTE] If you are an existing Cloudimage customer and wish to be able to remove the v7 from your URL syntax, please contact our support.

Image filters

Filters allow you to edit your images on-the-fly by applying different effects. Below is a list of the available filters. For more details, click on the respective filter.

Filter list

filtersyntaxdescription
brightnessbright=X | f=bright:Xadjusts the brightness of the image
contrastcontrast=X | f=contrast:Xadjusts the contrast of the image
greyscalegrey=1 | f=grey |
gray=1
| f=gray
converts the image to black and white
pixellatepixellate=X | f=pixellate:X |
pixelate=X | f=pixelate:X
X - size of block (in pixels)
pixellates the image into X-pixel-sized blocks
blurblur=X | f=blur:X
X - radius (in pixels)
applies Gaussian blur effect
sharpensharp=X | f=sharp:X
X - radius (in pixels)
applies unsharp mask effect to sharpen the image
rounded cornersradius=X | f=radius:X
X - corner radius (in pixels)
rounds the corners of the image
bg_colour=X | bg_color=X
X - corner colour (hex code or name)
fills the rounded corners with a specified colour
face blurringblur_faces=1 | blur_faces=TH,R,S,CR
TH - detection threshold, R - blur radius
S - blur sigma, CR - corner radius (in pixels or max)
detects the faces in the image and fogs them

Do not hesitate to contact us if you need any additional filters not listed above.

Combining filters

To use more than one filter, you can either use separate commands or concatenate them with commas: