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 crop

Finds the most prominent face in the image and crops it to specified dimensions (width and height).

func=face

Original image, cropped

/sample.li/business-portfolio.jpg?w=400&h=300&func=crop

Face crop

/sample.li/business-portfolio.jpg?w=400&h=300&func=face

Crop margins

To control the margin when cropping the face, you can use the face_margin=X[,Y] operation when Y is the vertical margin and X is the horizontal margin. If only one number is supplied, horizontal and vertical margins are equal. X and Y are in percent of the face width and height, respectively. Default value is 20.

Symmetric margins

/sample.li/classroom.jpg?h=240&func=face&face_margin=100

Horizontal and vertical margins

/sample.li/business-portfolio.jpg?w=400&h=300&func=face&face_margin=200,100

Automatic aspect ratio

You can use func=face to crop only the face in the image. If you provide only width or height, the other dimension will be chosen automatically.

Original image

/sample.li/classroom.jpg?h=240

Auto aspect ratio

/sample.li/classroom.jpg?h=240&func=face