Sagging API Response Scheme

Haut.AI provides an AI algorithm that evaluates the condition of nasolabial folds.

The algorithm is deprecated. We suggest to use Lines algorithm that includes sagging

Description

“Smile lines”, or nasolabial folds, are a common facial feature. These folds run from each side of the nose to the corners of the mouth. The formation of nasolabial folds is associated with the structure of the human face, sagging of midface soft tissue, and a prominent decline in facial muscle tone, which is caused by aging.

The higher the value of this parameter, the less saggy the skin.

"algorithm_tech_name": "sagging"

area_name

The algorithm returns metrics for the following facial areas:

• face

• right_cheek

• left_cheek

main_metric

The main metric is an overall score indicating the quality of each area_name

"main_metric": {
                "value": 0,
                "widget_type": "bad_good_line",
                "name": "Sagging Score",
                "tech_name": "sagging_score",
                "widget_meta": null
            },

• value the sagging score ranges from [0,100]. The higher the value of this parameter, the less saggy the face. The sagging can be classified into six classes based on value:

  • (90,100] - Excellent

  • (80,90] - Great

  • (70,80] - Good

  • (50,70] - Average

  • (30, 50] - Poor

  • [0,30] - Bad

• "widget_type": "bad_good_line" indicates that a higher value is better.

• "name": "Sagging score"

• "tech_name": "sagging_score"

sub_metrics

The algorithm doesn't return any.

masks_restored

The algorithm returns a vectorized mask of wrinkles for a face-aligned image.

• "mask_type": "polyline_mask"

• features

  • geometry

    • "type": "MultiLineString"

  See more on masks here.

masks_original

The algorithm returns a vectorized mask of wrinkles for an original image.

• "mask_type": "polyline_mask"

• features

  • geometry

    • "type": "MultiLineString"

  See more on masks here.

Example (JSON)

{
    "algorithm_tech_name": "sagging",
    "image_type": "selfie",
    "area_results": [
        {
            "area_name": "face",
            "main_metric": {
                "value": 11,
                "widget_type": "bad_good_line",
                "name": "Sagging Score",
                "tech_name": "sagging_score",
                "widget_meta": null
            },
            "sub_metrics": null
        },
        {
            "area_name": "right_cheek",
            "main_metric": {
                "value": 8,
                "widget_type": "bad_good_line",
                "name": "Sagging Score",
                "tech_name": "sagging_score",
                "widget_meta": null
            },
            "sub_metrics": null
        },
        {
            "area_name": "left_cheek",
            "main_metric": {
                "value": 14,
                "widget_type": "bad_good_line",
                "name": "Sagging Score",
                "tech_name": "sagging_score",
                "widget_meta": null
            },
            "sub_metrics": null
        },
    ],
    "masks_restored": [
         {
             "type": "FeatureCollection",
             "mask_type": "polyline_mask",
             "view_box": "0 0 2068 2068", 
             "name": "Skin sagging lines mask", 
             "tech_name": "sagging_mask_restored", 
             "fill": "#da52e4", 
             "features" : [
                 {
                     "geometry": {
                         "type": "MultiLineString", 
                         "coordinates": [
                             [
                                 [1194, 1088], [1305, 1225], [1399, 1302]
                             ], 
                             [
                                 [871, 1102], [860, 1118], [849, 1168], [831, 1208], [807, 1235], [781, 1278], [754, 1311], [733, 1331], [712, 1361], [698, 1368], [688, 1385]
                             ]
                         ]
                         "properties": {"intensity": 1.0}, 
                         "type": "feature"
                 }
             ]
         },
    ],
    "masks_original": [
         {
             "type": "FeatureCollection",
             "mask_type": "polyline_mask",
             "view_box": "0 0 2249 3300", 
             "name": "Skin sagging lines mask", 
             "tech_name": "sagging_mask_original", 
             "fill": "#da52e4", 
             "features" : [
                 {
                     "geometry": {
                         "type": "MultiLineString", 
                         "coordinates": [
                             [
                                 [1398, 1459], [1509, 1596], [1603, 1673]
                             ], 
                             [
                                 [1075, 1473], [1064, 1489], [1053, 1539], [1035, 1579], [1011, 1606], [985, 1649], [958, 1682], [937, 1702], [916, 1732], [902, 1739], [892, 1756]5]
                             ]
                         ]
                         "properties": {"intensity": 1.0}, 
                         "type": "feature"
                 }
             ]
         },
    ],
}