1. caricature


Name Type Minimum value Maximum value Default value Description
type int 0 -1  

Morphing type:
-1 - no morphing,
0 - random morphing (it is pseudo-random, in fact, because 'randomness' is determined by the random_seed number),
1 - smile,
2 - sad,
3 - surprised,
4 - squint eyed,
5 - troll,
6 - wink,
7 - flirt (smile, one eyebrow is raised),
8 - offended,
9 - Alien (narrow chin, wide set eyes),
10 - Martian (alien with small nose and huge eyes),
11 - bulb head (narow chin, wide forehead, big eyes),
12 - tough guy (big jaw, bulbous nose, one eyebrow is raised),
13 - grotesque,
14 - fat-cheeked.

random_seed int      

Number that determines the pseudo-random morphing type for type=0. All pseudo-random emotions can only change the mouth and the eyes area. They might not be found in the usual list of morphing types. The main advantage of pseudorandomness is that when sending the same request, the result is sure to be the same. This makes it possible to make repeated requests or make minor changes to requests (e.g. adding parameters like cartoon or crop_portrait), without changing emotion type. The same random_seed number always results in the same emotion type. If you want to apply different 'random' emotion types to the same face, you should send requests with different random_seed values.

strength float -1 -1 1

This parameter is available only for type = 1 and 2.
If this value is -1, the emotion can be described as normal / moderate.
If the value is 1, the emotion is exaggerated.
If the value is 0, no emotion at all is applied.
If the value is a number between 0 and 1 - middle state between no emotion and an exaggerated emotion.

crop_portrait bool FALSE    

If the value is true, a photo is cropped to contain only the face area. Only one face (the first face found by the algorithm) is cropped from any photo.

cartoon bool FALSE    

If the value is true, the resulting image is edited with the cartoon filter (see cartoon).