This API is executed via a GET request.

The following values are mandatory:

• URL: Please provide a complete URL to an image. The API must be able to download the image to execute the request.

Other optional values:

• PADDING: This value defines the distance of the recognized face to the edge of the image. The higher the value, the greater the distance. The value can also contain minus. Only complete numbers are recognized. No comma numbers. The value is given in pixels from the original image.
• WIDTH: You can specify an optional output resolution. When you pass a WIDTH value you must also pass a HEIGHT value. The value is given in pixels. The aspect ratio must not be greater than 2:1. Allowed is for example 200x100 pixel or 100x200 pixel.
• HEIGHT: The same rules apply for HEIGHT as for WIDTH

If no value is specified for WIDTH and HEIGHT, the image is output in its original size. The default output of the images is in an aspect ratio of 1:1
The images are output as JPG encoded as BASE64.
Multiple faces can be detected per image.