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.

Centred crop

Crops the image to specified dimensions (width and height), keeps proportions and delivers the resulting image via CDN.

func=crop

Original image, only resized

/sample.li/birds.jpg?w=400

If you set both width and height options, you can omit the func=crop option since it is the default operation for this case.

Gravity

Specifies which part of the image you wish to keep while cropping. If you omit the gravity option, centred cropping is performed.

gravity=X

Available gravity values

northwestnorthnortheast
westcentre | center (default)east
southwestsouthsoutheast
auto (more information)X,Y - focal point (more information)face (more information)

Cropped to 270x200

/sample.li/birds.jpg?w=400&h=290

By default, Cloudimage crops the image centrally.

Cropped to 400x290px, keeping the left part

/sample.li/birds.jpg?w=400&h=290&gravity=west

To position the crop, use the gravity operation. Here, gravity=west means that Cloudimage will focus on the left part of the image when cropping

To focus a crop on the most prominent object on the image, you can use automatic crop.

If you need full cropping control, please see positionable crop and focal point crop.

Face crop looks for faces in the image and focuses on the most prominent one while face hide crops out the topmost part of an image if it contains a face.