Face crop

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

func=face

Original image, cropped

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

Face crop

/v7/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.

Symmetric margins

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

Horizontal and vertical margins

/v7/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

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

Auto aspect ratio

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