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.

Face blurring

blur_faces=1

blur_faces=TH,R,S,CR

For censorship or privacy, you can use the blur_faces filter which will fog all faces found in the image by applying Gaussian blur.

Example

Available options

parameterdescriptiondefault valuedescription
THthreshold of the face detection algorithm0.15threshold of the face detection algorithm
Rblur radius30
Sblur sigma (Gaussian distribution)1000
CRcorner radius of the masking shape
(use max for an ellipse)
0corner radius of the masking shape
use max for an ellipse

If you are unsure which settings you should use, you can start with default values (blur_faces=1). The filter is turned off by omitting it or using blur_faces=0.

Face blurring is most effective for images with enough spatial resolution and sufficiently high quality. For example, for crowd shots, the recommended size is at least 800 pixels.