Skip to main content

AILabTools API - Skin analyze Pro - API:V1.6.2(DEPRECATED)

draft: true​

Important Announcement: API Version Update Notice

Dear Developers,

We are thrilled to announce that our API is receiving a major update! The new version will introduce a host of improvements and feature enhancements to enhance your development experience and meet your needs.

However, along with the rollout of the new version, we must also inform you that the old version of the API will no longer receive maintenance and support. This means that we will no longer release new features, fix known issues, or provide technical support for the old version of the API.

We strongly encourage you to upgrade to the latest version of the API as soon as possible to ensure that your applications continue to operate smoothly and to take advantage of the latest features and optimizations.

If you have any questions or need assistance regarding this change, please feel free to contact our support team ([email protected]). We are committed to assisting you and ensuring a smooth transition.

Once again, thank you for your support and trust in our API.

Best Regards,

AILabTools Support Team

Request​

  • URL: https://www.ailabapi.com/api/portrait/analysis/skin-analysis-pro
  • Method: POST
  • Content-Type: multipart/form-data

Image requirements​

  • Image format: JPG JPEG
  • Image size: No more than 8 MB.
  • Image resolution: Larger than 200x200px, smaller than 4096x4096px.
  • Minimum face pixel size: To ensure the effect, the minimum value of the face box (square) side length in the image should preferably be higher than 400px.
  • Face quality: The higher the face quality, the more accurate the skin analysis. Factors affecting face quality include: occlusion of facial features, blurred images, improper lighting (bright, dark, backlight), excessive face angle (yaw ≤ ±30°, pitch ≤ ±40° recommended), etc.
FieldRequiredTypeDescription
ailabapi-api-keyYESstringApplication API KEY. Get API KEY

Body​

FieldRequiredTypeScopeDescription
imageYESfileMain Image.
left_side_imageNOfileSide face picture.(Left)
right_side_imageNOfileSide face picture.(Right)
return_mapsNOstring
  • red_area
  • brown_area
  • texture_enhanced_pores
  • texture_enhanced_blackheads
  • texture_enhanced_oily_area
  • texture_enhanced_lines
  • water_area
  • rough_area
  • roi_outline_map
  • texture_enhanced_bw
    		• The type of skin problem detection mapping image to be returned. If the corresponding element parameter is passed in, the interface will return an image of the original size, which you can subsequently overlay with the original image to see the results. Use commas to separate multiple types. More Details
    return_marksNOstring
  • wrinkle_mark
  • right_nasolabial_list
  • right_mouth_list
  • right_eye_wrinkle_list
  • right_crowsfeet_list
  • right_cheek_list
  • left_nasolabial_list
  • left_mouth_list
  • left_eye_wrinkle_list
  • left_crowsfeet_list
  • left_cheek_list
  • glabella_wrinkle_list
  • forehead_wrinkle_list
  • dark_circle_outline
  • sensitivity_mark
  • melanin_mark
  • dark_circle_outline
  • cheekbone_mark
    		• The type of skin problem detection mapping image to be returned. Use commas to separate multiple types. More Details
    roi_outline_colorNOjson stringCustomize the color. More Details
    return_side_resultsNOstring
  • jawline_info
    		• The side face information that needs to be returned. Use commas to separate multiple types. More Details

    return_maps​

    • Request Example

      red_area,brown_area

    • Field Parsing

    FieldDescriptionReturn image information
    red_areaRed zone map to show areas of redness caused by facial sensitivity and inflammationA map of the red zone on a white background, with shades of red characterizing the degree of sensitivity.
    brown_areaBrown area map to show areas of facial pigmentationA map of brown areas on a white background, with shades of brown characterizing the degree of chromatophoresis.
    texture_enhanced_poresFacial pore enlargement area mapTransparent background PNG, labeled pore size area, image size is the same as the original image, can be stacked to view.
    texture_enhanced_blackheadsFacial blackhead area mapTransparent background PNG, labeled black head area, image size is the same as the original image, can be stacked to view.
    texture_enhanced_oily_areaFacial oil shine area mapTransparent background PNG, labeled facial shine area, image size is the same as the original image, can be stacked to view.
    texture_enhanced_linesFacial texture map, mark the more obvious deep lines and light lines on the faceTransparent background PNG, labeled facial wrinkles, image size is the same as the original image, can be stacked to view.
    water_areaFacial moisture map, showing facial dehydration areas, the darker the blue color means the more dehydrated the skin isPNG on white background, labeled facial dehydration area, same image size as the original.
    rough_areaFacial roughness map showing the rough areas of the faceTransparent background PNG, labeled facial rough areas, image size is the same as the original image, can be stacked to view.
    roi_outline_mapFacial blemishes and acne coordinates mappingTransparent background PNG, labeled facial spots and acne areas, image size is the same as the original image, can be overlaid with the original image for viewing.
    texture_enhanced_bwFacial blackheads & enlarged pores black & white enhancement chartJPG with crop, interface with return coordinates and cropped scale that can correspond to the pixel coordinates in the original image.

    return_marks​

    • Request Example

      wrinkle_mark,right_nasolabial_list

    • Field Parsing

    FieldDescription
    wrinkle_markFacial forehead, nose, crow's feet, cheeks, and contour coordinates of the area between the eyebrows
    right_nasolabial_listCoordinates, depth, and length of the right wrinkle
    right_mouth_listCoordinates, depth, and length of the wrinkles in the right corner of the mouth
    right_eye_wrinkle_listCoordinates, depth, and length of subwrinkles in the right eye area
    right_crowsfeet_listCoordinates, depth and length of crows feet wrinkles on the right eye
    right_cheek_listRight cheek wrinkle pattern, depth and length
    left_nasolabial_listCoordinates, depth, and length of the left legal sub-wrinkle
    left_mouth_listCoordinates, depth and length of wrinkles in the left corner of the mouth
    left_eye_wrinkle_listCoordinates, depth, and length of the left eye subwrinkle
    left_crowsfeet_listCoordinates, depth, and length of crow's feet wrinkles on the left eye
    left_cheek_listLeft cheek wrinkle pattern, depth and length
    glabella_wrinkle_listCoordinates, depth, and length of sub-frown lines between eyebrows
    forehead_wrinkle_listForehead wrinkle coordinates, depth and length
    dark_circle_outlineLeft and right eye dark circle contour line coordinates
    sensitivity_markRed zone coordinates, which provide coordinates of red areas caused by facial sensitivity and inflammation
    melanin_markArea coordinates for hyperpigmented areas of the face
    dark_circle_outlineLeft and right eye dark circle contour line coordinates
    cheekbone_markFacial apple coordinates

    roi_outline_color​

    • Request Example

      {"pores_color":"0000FF","blackhead_color":"FF0000","wrinkle_color":"6E9900","fine_line_color":"8DFE2A","closed_comedones_color":"00FF00","acne_pustule_color":"9F21F6","acne_nodule_color":"FF00FD","acne_color":"FE0100","brown_spot_color":"7E2A28"}

    • Field Parsing

    FieldDefaultDescription
    pores_color0000FFPore drawing color
    blackhead_colorFF0000Blackhead drawing color
    wrinkle_color6E9900Deep grain drawing color
    fine_line_color8DFE2AFine line drawing color
    closed_comedones_color00FF00Closed port drawing color
    acne_pustule_color9F21F6Pustular papules color
    acne_nodule_colorFF00FDAcne nodules drawing color
    acne_colorFE0100Light papules drawing color
    brown_spot_color7E2A28Pigmentation color
    tip

    Example: CC00FF format stands for R:CC, G:00, B:FF respectively.

    The input format is limited to a 6-bit hexadecimal string and is not case-sensitive.

    If not modified, it will draw directly using the default parameter colors.

    return_side_results​

    • Request Example

      jawline_info

    • Field Parsing

    FieldDescription
    jawline_infoThe user selects the jawline_info element and uploads the left and right side face image parameters to return the corresponding side face results, which can return three fields in the left_side_result and right_side_result structures for the side face image quality judgment, jawline angle and jawline coordinates.

    Response​

    Processing Flow

    1. Handle Public Parameters:

      First, parse and validate the Public Parameters, checking the status code or response message to ensure the request is successful and no errors are present.

    2. Handle Business Parameters:

      If the public parameters are valid and no exceptions are found, proceed to process the business logic in the Business Parameters.

    Public Parameters​

    Viewing Public Parameters and Error Codes

    Business Parameters​

    FieldTypeDescription
    left_side_resultjson stringResults of side face analysis. More Details
    right_side_resultjson stringResults of side face analysis. More Details
    face_rectangleobjectFace position. More Details
    resultobjectResults of face skin analysis. More Details

    left_side_result​

    FieldTypeScopeDescription
    +left_jawline_qualityinteger
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
    		• Side face photo quality. When you select the jawline function during the entry, you can take the corresponding picture to call the interface and judge the side face.
  • 1: The quality is excellent, and the angle of the side face shot of the human face for the uploaded photos is 20°~120°. Return the angle and coordinate result.
  • 2: The angle of the side face is slightly lower, and the angle of the side face of the photo is less than 20°. Do not return angle and coordinate results.
  • 3: The angle of the side face is slightly larger, and the angle of the side face of the photo is greater than 120°. Do not return angle and coordinate results.
  • 4: No face is detected. Do not return angle and coordinate results.
  • 5: Invalid human face. Do not return angle and coordinate results.
  • 6: Other situations. Do not return angle and coordinate results.
    • +left_jawline_anglefloatThe angle of the jawline.
    +left_jawline_markarrayCoordinates of jawline face key points.

    right_side_result​

    FieldTypeScopeDescription
    +right_jawline_qualityinteger
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
    		• Side face photo quality. When you select the jawline function during the entry, you can take the corresponding picture to call the interface and judge the side face.
  • 1: The quality is excellent, and the angle of the side face shot of the human face for the uploaded photos is 20°~120°. Return the angle and coordinate result.
  • 2: The angle of the side face is slightly lower, and the angle of the side face of the photo is less than 20°. Do not return angle and coordinate results.
  • 3: The angle of the side face is slightly larger, and the angle of the side face of the photo is greater than 120°. Do not return angle and coordinate results.
  • 4: No face is detected. Do not return angle and coordinate results.
  • 5: Invalid human face. Do not return angle and coordinate results.
  • 6: Other situations. Do not return angle and coordinate results.
    • +right_jawline_anglefloatThe angle of the jawline.
    +right_jawline_markarrayCoordinates of jawline face key points.

    face_rectangle​

    FieldTypeDescription
    +topfloatThe vertical coordinate of the pixel point in the upper-left corner of the rectangle box.
    +leftfloatThe horizontal coordinate of the pixel point in the upper-left corner of the rectangle.
    +widthfloatThe width of the rectangle box.
    +heightfloatThe height of the rectangle box.

    result​

    Modules
    Image quality
    Skin Type Analysis
    Roughness analysis
    Pigmentation
    Acne Analysis
    Sensitivity Analysis
    Senescence analysis
    Eye Analysis
    Overall Score
    Customization
    Image quality​
    FieldTypeScopeDescription
    +image_qualityjson string
    ++face_ratiofloatThe proportion of the human face to the whole photo.
    ++face_orientationobjectFace 3D angle.
    +++yawfloatYaw angle. The angle of rotation around the Y-axis. It is expressed as the horizontal rotation of the head to the left or right.
    +++pitchfloatPitch angle. The angle of rotation around the X-axis. Expressed as head pitch and tilt.
    +++rollfloatScroll angle. The angle of rotation around the Z axis, expressed as the rotation of the face photo seen from the front.
    ++face_rectfloatThe coordinate value of the face can be keyed out by returning the coordinate value of the face according to the key point of the face.
    +++topfloat
    +++leftfloat
    +++widthfloat
    +++heightfloat
    ++hair_occlusionfloatThe proportion of bangs to the human face.
    Skin Type Analysis​
    FieldTypeScopeDescription
    +skin_typeobjectSkin texture test results.
    ++skin_typeinteger
  • 0
  • 1
  • 2
  • 3
    		• Type.
  • 0: Oily skin.
  • 1: Dry skin.
  • 2: Neutral skin.
  • 3: Combination skin.
    • ++detailsobjectThe confidence level of each classification.
    +++0objectOily skin information.
    ++++valueinteger
  • 0
  • 1
    		• Oily skin.
  • 0: No.
  • 1: Yes.
    • ++++confidencefloatConfidence.
    +++1objectDry skin information.
    ++++valueinteger
  • 0
  • 1
    		• Dry skin.
  • 0: No.
  • 1: Yes.
    • ++++confidencefloatConfidence.
    +++2objectNeutral skin information.
    ++++valueinteger
  • 0
  • 1
    		• Neutral skin.
  • 0: No.
  • 1: Yes.
    • ++++confidencefloatConfidence.
    +++3objectCombination skin information.
    ++++valueinteger
  • 0
  • 1
    		• Combination skin.
  • 0: No.
  • 1: Yes.
    • ++++confidencefloatConfidence.
    +oily_intensityobjectOil output level detection.
    ++t_zoneobjectT-zone.
    +++areaobject[0, 1]Area share.
    +++intensityinteger
  • 0
  • 1
  • 2
    		• Severity of oiling.
  • 0: No shine or slight shine.
  • 1: Medium shine phenomenon.
  • 2: Severe oiling.
    • ++left_cheekobjectLeft cheek.
    +++areaobject[0, 1]Area share.
    +++intensityinteger
  • 0
  • 1
  • 2
    		• Severity of oiling.
  • 0: No shine or slight shine.
  • 1: Medium shine phenomenon.
  • 2: Severe oiling.
    • ++right_cheekobjectRight cheek.
    +++areaobject[0, 1]Area share.
    +++intensityinteger
  • 0
  • 1
  • 2
    		• Severity of oiling.
  • 0: No shine or slight shine.
  • 1: Medium shine phenomenon.
  • 2: Severe oiling.
    • ++chin_areaobjectChin area.
    +++areaobject[0, 1]Area share.
    +++intensityinteger
  • 0
  • 1
  • 2
    		• Severity of oiling.
  • 0: No shine or slight shine.
  • 1: Medium shine phenomenon.
  • 2: Severe oiling.
    • +waterobjectThe percentage of dehydrated skin on the forehead, cheeks and chin, the percentage of overall facial dehydrated area and the severity of dehydration.
    ++water_severityfloat[0, 100]Severity of water shortage .
    ++water_areafloatPercentage of water deficit area .
    ++water_foreheadobjectPercentage of forehead deficiency area.
    +++areafloat[0, 1]Area share.
    ++water_rightcheekobjectPercentage of dehydrated area on the right cheek.
    +++areafloat[0, 1]Area share.
    ++water_leftcheekobjectPercentage of dehydrated area on the left cheek.
    +++areafloat[0, 1]Area share.
    +skin_toneobjectSkin color test results.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 4
    		• Skin color.
  • 0: Translucency.
  • 1: Fairness.
  • 2: Natural.
  • 3: Wheat.
  • 4: Tanned/Bronze.
    • ++confidencefloat[0, 1]Confidence.
    +skintone_itaobjectReturns skin color classification information based on the ITA (Individual Typology Angle) standard. NOTE
    ++ITAfloat[-90, 90]Angle value.
    ++skintoneinteger
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
    		• Classified according to the skin tone of ITA.
  • 0: Very light.
  • 1: Light.
  • 2: Intermediate.
  • 3: Tan.
  • 4: Brown.
  • 5: Dark.
  • 6: Abnormal color values that may be caused by weak lighting conditions or overexposure.
    • +skin_hue_haobjectReturns skin tone classification information based on HA (Hue Angle). NOTE
    ++HAfloat[0, 90]HA angle value.
    ++skintoneinteger
  • 0
  • 1
  • 2
  • 3
    		• Classified according to HA's skin tone hue.
  • 0: Yellowish.
  • 1: Neutral.
  • 2: Reddish.
  • 3: Abnormal hue values may be caused by abnormal ambient light tones or weak light environment or overexposure.
    • Roughness analysis​
    FieldTypeScopeDescription
    +blackheadobjectBlackhead information.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: No blackheads, number of blackheads ∈ [0, 45].
  • 1: Mild, number of blackheads ∈ [46, 90].
  • 2: Moderate, number of blackheads ∈ [91, 150].
  • 3: Severe, number of blackheads ∈ [151 or more].
    • ++confidencefloat[0, 1]Confidence.
    +blackhead_countintegerNumber of blackheads on the nose area.
    +enlarged_pore_countobjectThe number of enlarged pores and the percentage of enlarged pore area.
    ++foreheadobjectForehead.
    +++countintegerNumber of enlarged pores.
    +++areafloat[0, 1]Percentage of enlarged pore area.
    ++left_cheek_countobjectLeft cheek.
    +++countintegerNumber of enlarged pores.
    +++areafloat[0, 1]Percentage of enlarged pore area.
    ++right_cheek_countobjectRight cheek.
    +++countintegerNumber of enlarged pores.
    +++areafloat[0, 1]Percentage of enlarged pore area.
    ++chin_countobjectChin.
    +++countintegerNumber of enlarged pores.
    +++areafloat[0, 1]Percentage of enlarged pore area.
    +pores_foreheadobjectThe severity of enlarged forehead pores.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: No pores, number of pores ∈ [0, 100].
  • 1: Mildly, the number of pores ∈ [101, 200].
  • 2: Moderate, number of pores ∈ [201, 400].
  • 3: Severe, number of pores ∈ [401 or more].
    • ++confidencefloat[0, 1]Confidence.
    +pores_rightcheekobjectThe severity of enlarged pores on the right cheek.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: No pores, number of pores ∈ [0, 80].
  • 1: Mildly, the number of pores ∈ [81, 180].
  • 2: Moderate, number of pores ∈ [181, 280].
  • 3: Severe, number of pores ∈ [281 or more].
    • ++confidencefloat[0, 1]Confidence.
    +pores_leftcheekobjectThe severity of enlarged pores on the left cheek.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: No pores, number of pores ∈ [0, 80].
  • 1: Mildly, the number of pores ∈ [81, 180].
  • 2: Moderate, number of pores ∈ [181, 280].
  • 3: Severe, number of pores ∈ [281 or more].
    • ++confidencefloat[0, 1]Confidence.
    +pores_jawobjectThe severity of enlarged pores on the chin.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: No pores, number of pores ∈ [0, 50].
  • 1: Mildly, the number of pores ∈ [51, 100].
  • 2: Moderate, number of pores ∈ [101, 150].
  • 3: Severe, number of pores ∈ [151 or more].
    • ++confidencefloat[0, 1]Confidence.
    +roughobjectOutput the percentage of rough skin area on forehead, cheeks and chin, the percentage of overall facial rough area and the severity of roughness.
    ++rough_severityinteger[0, 100]Severity.
    ++rough_areafloat[0, 1]Area share.
    ++rough_foreheadobjectForehead.
    +++areafloat[0, 1]Area share.
    ++rough_rightcheekobjectRight cheek.
    +++areafloat[0, 1]Area share.
    ++rough_leftcheekobjectLeft cheek.
    +++areafloat[0, 1]Area share.
    ++rough_jawobjectJaw.
    +++areafloat[0, 1]Area share.
    Pigmentation​
    FieldTypeScopeDescription
    +melaninobjectReturn the skin pigmentation of the human face in the photo.
    ++brown_areafloat[0, 1]Percentage of full-face area of pigmented areas.
    ++melanin_concentrationfloat[0, 100]Degree of pigmentation.
    ++brown_foreheadfloat[0, 1]Percentage of forehead hyperpigmentation area.
    ++brown_rightcheekfloat[0, 1]Percentage of hyperpigmented area on the right cheek.
    ++brown_leftcheekfloat[0, 1]Percentage of hyperpigmented area on the left cheek.
    +melanin_markobjectInformation on the pigmented areas of the brown area map.
    ++polygonarrayA collection of polygon coordinates within the brown area map, each polygon representing the x and y coordinate values of the outer contour line of a hyperpigmented area.
    +++array
    ++++xfloat
    ++++yfloat
    +moleObjectInformation for each mole area.
    ++rectanglearrayThe position of each mole frame.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++confidencearrayThe confidence level of each mole region.
    ++polygonarrayWithin each mole box, the more detailed polygon contour lines of the problem area, returning the x and y coordinate values of the vertices of each polygon mole area.
    +++array
    ++++xfloat
    ++++yfloat
    +brown_spotObjectInformation for each discolored area.
    ++rectanglearrayThe position of each color spot box.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++confidencearrayConfidence level for each chromatophore region.
    ++polygonarrayA more detailed polygon contour line of the problem area within each color spot box, returning the x and y coordinate values of the vertices of each polygon acne area.
    +++array
    ++++xfloat
    ++++yfloat
    +melasmaObjectMelasma information.
    ++valueinteger
  • 0
  • 1
  • 0: No melasma.
  • 1: There is melasma.
    • ++confidencefloatConfidence.
    +freckleObjectFreckle information.
    ++valueinteger
  • 0
  • 1
  • 0: No freckles.
  • 1: There are freckles.
    • ++confidencefloatConfidence.
    Acne Analysis​
    FieldTypeScopeDescription
    +acneObjectAcne Test - Light Papule Test (Light papules are a category of less symptomatic acne phenomena that present as rice- to soy-sized bumps accompanied by inflammatory redness and symptoms such as pain and itching) returns a rectangular box for each papule area and a more detailed polygon box.
    ++rectanglearrayThe location of each papule box.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++confidencearrayConfidence level of each papule box.
    ++polygonarrayWithin each papule box, the more detailed polygonal contour lines of the problem area return the x and y coordinate values of the vertices of each polygonal papule area.
    +++array
    ++++xfloat
    ++++yfloat
    +acne_pustuleObjectAcne Detection - Pustular Papule Detection (Pustular papules are acne phenomena with milky, yellowish pus visible to the naked eye and appear as mound-like bumps with milky, yellowish pus) returns rectangular boxes and more detailed polygonal boxes for each area of pustular acne.
    ++rectanglearrayThe location of each pustule box.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++confidencearrayConfidence level of each pustule box.
    ++polygonarrayThe more detailed polygonal contour lines of the problem area within each pustule box, returning the x and y coordinate values of the vertices of each polygonal pustule area.
    +++array
    ++++xfloat
    ++++yfloat
    +acne_noduleObjectAcne Detection - Acne Nodule Detection (Acne nodules are a more severe type of acne phenomenon that appears as small, pea-sized bumps that are hard to the touch caused by the accumulation of subcutaneous lipids and pus) returns a rectangular box and a more detailed polygon box for each acne nodule area.
    ++rectanglearrayThe position of each nodal box.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++confidencearrayThe confidence level of each nodal box.
    ++polygonarrayWithin each nodal box, the more detailed polygon contour lines of the problem region, returning the x and y coordinate values of the vertices of each polygon nodal region.
    +++array
    ++++xfloat
    ++++yfloat
    +acne_markObjectRed Acne Mark Detection - Detects red-purple acne marks that appear after facial acne has healed returning rectangular boxes and more detailed polygonal boxes for each acne mark area.
    ++rectanglearrayThe location of each pockmark box.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++confidencearrayConfidence level of each pockmark box.
    ++polygonarrayA more detailed polygon contour line of the problem area within each pockmark box, returning the x and y coordinate values of the vertices of each polygon pockmark area.
    +++array
    ++++xfloat
    ++++yfloat
    +closed_comedonesObjectRectangular boxes and more detailed polygonal boxes for each occlusive acne area.
    ++rectanglearrayThe location of each closed-cell acne box.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++confidencearrayConfidence level of each closed-jaw acne box.
    ++polygonarrayA more detailed polygon contour line of the problem area within each closed acne box, returning the x and y coordinate values of the vertices of each polygon closed acne area.
    +++array
    ++++xfloat
    ++++yfloat
    Sensitivity Analysis​
    FieldTypeScopeDescription
    +sensitivityobjectThe sensitivity of the face within the photo is judged.
  • This return value must be used with red area maps, and you need to set the return red area map (red_area) in the input parameter return_maps first.
    • ++sensitivity_areafloat[0, 1]The percentage of sensitive skin area on the whole face. Sensitive redness areas include cheeks, T-zone, etc.
    ++sensitivity_intensityfloat[0, 100]The intensity of redness in sensitive areas.
    +sensitivity_markobjectThe location of the polygon box in the sensitive muscle area of the red zone diagram.
    ++polygonarrayThe set of polygon coordinates within the red zone map, each polygon represents the x and y coordinate values of the outer contour line of a sensitive muscle region.
    +++array
    ++++xfloat
    ++++yfloat
    Senescence analysis​
    FieldTypeScopeDescription
    +skin_ageobjectSkin age test results.
    ++valueinteger[0, 100]Skin age.
    +forehead_wrinkleobjectResults of the head lift test.
    ++valueinteger
  • 0
  • 1
  • 0: No head lines.
  • 1: There are head lines.
    • ++confidencefloat[0, 1]Confidence.
    +crows_feetobjectCrow's feet test results.
    ++valueinteger
  • 0
  • 1
  • 0: No crow's feet.
  • 1: With crow's feet.
    • ++confidencefloat[0, 1]Confidence.
    +eye_finelinesobjectResults of the eye fine lines test.
    ++valueinteger
  • 0
  • 1
  • 0: No fine lines under the eyes.
  • 1: With fine lines under the eyes.
    • ++confidencefloat[0, 1]Confidence.
    +glabella_wrinkleobjectResults of the interbrow line test.
    ++valueinteger
  • 0
  • 1
  • 0: No interbrow lines.
  • 1: With interbrow lines.
    • ++confidencefloat[0, 1]Confidence.
    +nasolabial_foldobjectResults of the forehead line test.
    ++valueinteger
  • 0
  • 1
  • 0: No lines.
  • 1: There are lines.
    • ++confidencefloat[0, 1]Confidence.
    +nasolabial_fold_severityobjectSeverity of the forehead lines. Returned when [nasolabial_fold=1].
    ++valueinteger
  • 0
  • 1
  • 2
  • 0: Mild.
  • 1: Moderate.
  • 2: Severe.
    • ++confidencefloat[0, 1]Confidence.
    +left_mouth_wrinkle_severityobjectThe presence & severity of marionette lines on the left side of the face.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_mouth_wrinkle_severityobjectThe presence & severity of marionette lines on the right side of the face.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +forehead_wrinkle_severityobjectThe severity of the headline. Returned when [forehead_wrinkle=1].
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +left_crows_feet_severityobjectThe presence & severity of crow's feet on the left side of the face.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_crows_feet_severityobjectThe presence & severity of crow's feet on the right side of the face.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +left_eye_finelines_severityobjectThe presence & severity of fine lines under the eyes on the left side of the face.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_eye_finelines_severityobjectThe presence & severity of fine lines under the eyes on the right side of the face.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +glabella_wrinkle_severityobjectThe presence & severity of fine lines between the eyebrows.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +left_nasolabial_fold_severityobjectThe presence or absence & severity of the left facial lines.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_nasolabial_fold_severityobjectThe presence or absence & severity of right facial lines.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +left_cheek_wrinkle_severityobjectThe presence & severity of left cheek lines.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_cheek_wrinkle_severityobjectThe presence & severity of right cheek lines lines.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +fine_lineobjectNumber of fine lines detected.
    ++forehead_countintegerForehead.
    ++left_undereye_countintegerFine lines in the left eye.
    ++right_undereye_countintegerFine lines in the right eye.
    ++left_cheek_countintegerLeft cheek.
    ++right_cheek_countintegerRight cheek.
    ++left_crowsfeet_countintegerCrow's feet in the left eye.
    ++right_crowsfeet_countintegerCrow's feet in the right eye.
    ++glabella_countintegerInterbrow lines.
    +wrinkle_countobjectNumber of deep grain detection.
    ++forehead_countintegerForehead.
    ++left_undereye_countintegerFine lines in the left eye.
    ++right_undereye_countintegerFine lines in the right eye.
    ++left_cheek_countintegerLeft cheek.
    ++right_cheek_countintegerRight cheek.
    ++left_crowsfeet_countintegerCrow's feet in the left eye.
    ++right_crowsfeet_countintegerCrow's feet in the right eye.
    ++glabella_countintegerInterbrow lines.
    ++left_mouth_countintegerPuppet pattern at the left corner of the mouth.
    ++right_mouth_countintegerPuppet pattern at the right corner of the mouth.
    ++left_nasolabial_countintegerThe left legal line.
    ++right_nasolabial_countintegerThe right wrinkle.
    +forehead_wrinkle_infoobjectNumber of deep grain detection.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +left_eye_wrinkle_infoobjectLeft eye wrinkle information.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +right_eye_wrinkle_infoobjectRight eye wrinkle information.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +left_crowsfeet_wrinkle_infoobjectLeft fishtail information.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +right_crowsfeet_wrinkle_infoobjectRight fishtail information.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +glabella_wrinkle_infoobjectInformation on the lines between the eyebrows.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +left_mouth_wrinkle_infoobjectInformation on the left corner of the mouth tattoo.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +right_mouth_wrinkle_infoobjectInformation on the right corner of the mouth tattoo.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +left_nasolabial_wrinkle_infoobjectInformation about the left legal line.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +right_nasolabial_wrinkle_infoobjectInformation on the right-hand wrinkle.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +left_cheek_wrinkle_infoobjectLeft face wrinkle information.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +right_cheek_wrinkle_infoobjectRight face wrinkle information.
    ++wrinkle_scoreinteger[0, 100]Wrinkle score.
    ++wrinkle_severity_levelinteger
  • 0
  • 1
  • 2
  • 3
    		• Wrinkle severity level.
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • ++wrinkle_norm_lengthfloatWrinkle-normalized length.
    ++wrinkle_norm_depthfloatWrinkle normalized depth.
    ++wrinkle_pixel_densityfloatWrinkle pixel density.
    ++wrinkle_area_ratiofloat[0, 1]Percentage of wrinkled area.
    ++wrinkle_deep_ratiofloat[0, 1]Percentage of deep grain length.
    ++wrinkle_deep_numintegerNumber of deep lines.
    ++wrinkle_shallow_numintegerNumber of shallow lines.
    ++forehead_wrinkle_listarraySub-wrinkle information.
    +++wrinkle_coordarraySubwrinkle pixel coordinates.
    ++++xfloat
    ++++yfloat
    +++wrinkle_coordfloatSub-wrinkle depth.
    +++wrinkle_lengthfloatSubwrinkle length.
    +cheekbone_markobjectInformation about the coordinates of the left apple muscle and the coordinates of the right apple muscle.
    ++left_cheekbone_markarrayLeft apple muscle coordinates.
    +++xfloat
    +++yfloat
    ++left_cheekbone_markarrayRight apple muscle coordinates.
    +++xfloat
    +++yfloat
    Eye Analysis​
    FieldTypeScopeDescription
    +eye_pouchobjectEye bag test results.
    ++valueinteger
  • 0
  • 1
  • 0: No bags under the eyes.
  • 1: With bags under the eyes.
    • ++confidencefloatConfidence.
    +eye_pouch_severityobjectSeverity of eye bags. Return when [eye_pouch.value=1].
    ++valueinteger
  • 0
  • 1
  • 2
  • 0: Mild.
  • 1: Moderate.
  • 2: Severe.
    • ++confidencefloatConfidence.
    +left_eye_pouch_rectanglearrayThe position of the left eye bag frame
    ++widthfloatWidth.
    ++heightfloatHeight.
    ++leftfloatThe distance from the leftmost part of the picture.
    ++topfloatThe distance from the topmost edge of the image.
    +right_eye_pouch_rectanglearrayThe position of the right eye bag frame
    ++widthfloatWidth.
    ++heightfloatHeight.
    ++leftfloatThe distance from the leftmost part of the picture.
    ++topfloatThe distance from the topmost edge of the image.
    +dark_circleobjectDark eye circle type detection.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: No dark circles under the eyes.
  • 1: Pigmented dark circles.
  • 2: Vascular dark circles.
  • 3: Dark circles with shadows.
    • ++confidencefloatConfidence.
    +dark_circle_severityobjectSeverity of dark circles under the eyes. Return when [dark_circle.value <> 1].
    ++valueinteger
  • 0
  • 1
  • 2
  • 0: Mild.
  • 1: Moderate.
  • 2: Severe.
    • ++confidencefloatConfidence.
    +left_dark_circle_reteobjectSeverity of vascular type dark circles under the left eye.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_dark_circle_reteobjectSeverity of vascular type dark circles under the right eye.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +left_dark_circle_pigmentobjectSeverity of pigmented dark circles under the left eye.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_dark_circle_pigmentobjectSeverity of pigmented dark circles under the right eye.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +left_dark_circle_structuralobjectSeverity of structural dark circles under the left eye..
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +right_dark_circle_structuralobjectSeverity of structural dark circles under the right eye.
    ++valueinteger
  • 0
  • 1
  • 2
  • 3
  • 0: None.
  • 1: Mild.
  • 2: Moderate.
  • 3: Severe.
    • +dark_circle_markobjectThe position of the rectangular box coordinates of the black eye.
    ++left_eye_rectobjectLeft eye.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++right_eye_rectobjectRight eye.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    +left_eye_pouch_rectobjectLeft eye bag rectangular box position.
    ++widthfloatWidth.
    ++heightfloatHeight.
    ++leftfloatThe distance from the leftmost part of the picture.
    ++topfloatThe distance from the topmost edge of the image.
    +right_eye_pouch_rectobjectRight eye bag rectangular box position.
    ++widthfloatWidth.
    ++heightfloatHeight.
    ++leftfloatThe distance from the leftmost part of the picture.
    ++topfloatThe distance from the topmost edge of the image.
    +wrinkle_markobjectWrinkle contour line coordinates.
    ++left_eye_wrinkle_outlinearrayWrinkles in the left eye.
    +++xfloat
    +++yfloat
    ++right_eye_wrinkle_outlinearrayWrinkles in the Right eye.
    +++xfloat
    +++yfloat
    ++left_cheek_wrinkle_outlinearrayWrinkles on the left side of the face.
    +++xfloat
    +++yfloat
    ++right_cheek_wrinkle_outlinearrayWrinkles on the right side of the face.
    +++xfloat
    +++yfloat
    ++glabella_wrinkle_outlinearrayInterbrow lines.
    +++xfloat
    +++yfloat
    ++left_nasolabial_wrinkle_outlinearrayThe left legal line.
    +++xfloat
    +++yfloat
    ++right_nasolabial_wrinkle_outlinearrayThe right legal line.
    +++xfloat
    +++yfloat
    ++left_crowsfeet_wrinkle_outlinearrayLeft fishtail line..
    +++xfloat
    +++yfloat
    ++right_crowsfeet_wrinkle_outlinearrayRight fishtail line..
    +++xfloat
    +++yfloat
    ++left_mouth_wrinkle_outlinearrayLeft corner of the mouth tattoo.
    +++xfloat
    +++yfloat
    ++right_mouth_wrinkle_outlinearrayRight corner of the mouth tattoo.
    +++xfloat
    +++yfloat
    ++head_wrinkle_outlinearrayForehead wrinkles.
    +++xfloat
    +++yfloat
    +dark_circle_outlineobjectDark eye contour coordinates.
    ++left_dark_circle_outlinearrayLeft eye.
    +++xfloat
    +++yfloat
    ++right_dark_circle_outlinearrayRight eye.
    +++xfloat
    +++yfloat
    Overall Score​
    FieldTypeScopeDescription
    +score_infoobjectScore. Degree & Score
    ++dark_circle_scorefloat[0, 100]Dark Circles Score
    ++skin_type_scorefloat[0, 100]Skin Quality Score
    ++wrinkle_scorefloat[0, 100]Wrinkle Score
    ++oily_intensity_scorefloat[0, 100]Oily Score
    ++pores_scorefloat[0, 100]Pore Score
    ++blackhead_scorefloat[0, 100]Blackheads Score
    ++acne_scorefloat[0, 100]Acne Score
    ++sensitivity_scorefloat[0, 100]Sensitivity Score
    ++melanin_scorefloat[0, 100]Melanin Score
    ++water_scorefloat[0, 100]Skin Moisture Score
    ++rough_scorefloat[0, 100]Skin Roughness Score
    Customization​
    FieldTypeScopeDescription
    +enhanced_bw_infoobjectBlack and white enhanced map coordinates location. Conversion formula
    ++enhanced_bw_rectobjectBlack and white enhanced graph coordinate frame.
    +++widthfloatWidth.
    +++heightfloatHeight.
    +++leftfloatThe distance from the leftmost part of the picture.
    +++topfloatThe distance from the topmost edge of the image.
    ++ratiofloatCrop ratio.
    +face_mapsobjectSkin problem detection mapping picture.
  • Returns information based on the return_maps field input.
    • ++red_areabase64More Details
    ++brown_areabase64More Details
    ++texture_enhanced_poresbase64More Details
    ++texture_enhanced_blackheadsbase64More Details
    ++texture_enhanced_oily_areabase64More Details
    ++texture_enhanced_linesbase64More Details
    ++water_areabase64More Details
    ++rough_areabase64More Details
    ++roi_outline_mapbase64More Details
    ++texture_enhanced_bwbase64More Details

    skintone_ita​

    ITA (Individual Typology Angle) is an international standard for skin color, which is a method to classify skin color by measuring the color attributes of skin color Lab space. The method is strongly dependent on ambient light, we recommend using flash to take HD face photos for uploading and processing, the ITA angle value measured in natural light or dark environment may not be allowed or abnormal.

    According to the data taken by the rear flash of the phone, the current skin color classification reference.

    skintoneScopeDescription
    056 < ITA < 90Very light.
    143 < ITA <= 56Light.
    236 < ITA <= 43Intermediate.
    320 < ITA <= 36Tan.
    410 < ITA <= 20Brown.
    5-90 < ITA <= 10Dark.
    6OtherAbnormal color values that may be caused by weak lighting conditions or overexposure.
    tip

    You can also use the returned ITA value to define your classification based on the returned ITA angle at the time of access.

    skin_hue_ha​

    HA (Hue Angle) is an international standard for skin color, which is a method to classify skin color by measuring the color attributes of skin color Lab space. The method is strongly dependent on ambient light, we recommend using flash to take HD face photos for uploading and processing, the HA angle value measured in natural light or dark light environment may not be allowed or abnormal.

    According to the data taken by the rear flash of the phone, the current skin tone classification reference.

    skintoneScopeDescription
    049 < HA <= 90Yellowish.
    146 <= HA < 49Neutral.
    210 <= HA < 46Reddish.
    3OtherAbnormal hue values may be caused by abnormal ambient light tones or weak light environment or overexposure.
    tip

    You can also use the returned ITA value to define your classification based on the returned ITA angle at the time of access.

    Coordinate conversion formula between original image and black and white enhanced image​

    tip

    x_enhance = (x_img - left) * ratio

    y_enhance = (y_img - top) * ratio

    Coordinates of original image: x_img, y_img, coordinates of black and white enhanced image: x_enhance, y_enhance.

    Example​

    draft: true​

    JSON
    {
      "request_id": "",
      "log_id": "",
      "error_code": 0,
      "error_code_str": "",
      "error_msg": "",
      "error_detail": {
        "status_code": 200,
        "code": "",
        "code_message": "",
        "message": ""
      },
      "face_rectangle": {
        "top": 0,
        "left": 0,
        "width": 0,
        "height": 0
      },
      "left_side_result": {
        "left_jawline_quality": 1,
        "left_jawline_angle": 122.73,
        "left_jawline_mark": [
          {
            "x": 518,
            "y": 1256
          },
          {
            "x": 531,
            "y": 1260
          }
        ]
      },
      "right_jawline_info": {
        "right_jawline_quality": 1,
        "right_jawline_angle": 122.73,
        "right_jawline_mark": [
          {
            "x": 518,
            "y": 1256
          },
          {
            "x": 531,
            "y": 1260
          }
        ]
      },
      "result": {
        "image_quality": {
          "face_ratio:": 0.3,
          "face_orientation": {
            "yaw": 30.1,
            "pitch": 21.2,
            "roll": 89
          },
          "face_rect": {
            "top": 808,
            "left": 677,
            "width": 800,
            "height": 800
          },
          "hair_occlusion": 0.05,
          "glasses": 0
        },
        "skin_type": {
          "skin_type": 0,
          "details": {
            "0": {
              "value": 0,
              "confidence": 0.89
            },
            "1": {
              "value": 0,
              "confidence": 0.89
            },
            "2": {
              "value": 1,
              "confidence": 0.89
            },
            "3": {
              "value": 0,
              "confidence": 0.89
            }
          }
        },
        "oily_intensity": {
          "t_zone": {
            "area": 0,
            "intensity": 0
          },
          "left_cheek": {
            "area": 0,
            "intensity": 0
          },
          "right_cheek": {
            "area": 0,
            "intensity": 0
          },
          "chin_area": {
            "area": 0,
            "intensity": 0
          }
        },
        "water": {
          "water_severity": 0,
          "water_area": 0,
          "water_forehead": {
            "area": 0
          },
          "water_leftcheek": {
            "area": 0
          },
          "water_rightcheek": {
            "area": 0
          }
        },
        "skin_tone": {
          "value": 0,
          "confidence": 0
        },
        "skintone_ita": {
          "ITA": 0,
          "skintone": 0
        },
        "skin_hue_ha": {
          "HA": 0,
          "skin_hue": 0
        },
        "blackhead": {
          "value": 0,
          "confidence": 0
        },
        "blackhead_count": 0,
        "enlarged_pore_count": {
          "forehead": {
            "count": 0,
            "area": 0
          },
          "left_cheek_count": {
            "count": 0,
            "area": 0
          },
          "right_cheek_count": {
            "count": 0,
            "area": 0
          },
          "chin_count": {
            "count": 0,
            "area": 0
          }
        },
        "pores_forehead": {
          "value": 0,
          "confidence": 0
        },
        "pores_rightcheek": {
          "value": 0,
          "confidence": 0
        },
        "pores_leftcheek": {
          "value": 0,
          "confidence": 0
        },
        "pores_jaw": {
          "value": 0,
          "confidence": 0
        },
        "rough": {
          "rough_severity": 0,
          "rough_area": 0,
          "rough_forehead": {
            "area": 0
          },
          "rough_leftcheek": {
            "area": 0
          },
          "rough_rightcheek": {
            "area": 0
          },
          "rough_jaw": {
            "area": 0
          }
        },
        "melanin": {
          "brown_area": 0,
          "melanin_concentration": 0,
          "brown_forehead": 0,
          "brown_leftcheek": 0,
          "brown_rightcheek": 0
        },
        "melanin_mark": {
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "mole": {
          "rectangle": [
            {
              "width": 0,
              "top": 0,
              "height": 0,
              "left": 0
            }
          ],
          "confidence": [
            0
          ],
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "brown_spot": {
          "rectangle": [
            {
              "width": 0,
              "top": 0,
              "height": 0,
              "left": 0
            }
          ],
          "confidence": [
            0
          ],
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "melasma": {
          "value": 0,
          "confidence": 0
        },
        "freckle": {
          "value": 0,
          "confidence": 0
        },
        "acne": {
          "rectangle": [
            {
              "width": 0,
              "top": 0,
              "height": 0,
              "left": 0
            }
          ],
          "confidence": [
            0
          ],
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "acne_pustule": {
          "rectangle": [
            {
              "width": 0,
              "top": 0,
              "height": 0,
              "left": 0
            }
          ],
          "confidence": [
            0
          ],
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "acne_nodule": {
          "rectangle": [
            {
              "width": 0,
              "top": 0,
              "height": 0,
              "left": 0
            }
          ],
          "confidence": [
            0
          ],
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "acne_mark": {
          "rectangle": [
            {
              "width": 0,
              "top": 0,
              "height": 0,
              "left": 0
            }
          ],
          "confidence": [
            0
          ],
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "closed_comedones": {
          "rectangle": [
            {
              "width": 0,
              "top": 0,
              "height": 0,
              "left": 0
            }
          ],
          "confidence": [
            0
          ],
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "sensitivity": {
          "sensitivity_area": 0,
          "sensitivity_intensity": 0
        },
        "sensitivity_mark": {
          "polygon": [
            [
              {
                "x": 0,
                "y": 0
              }
            ]
          ]
        },
        "skin_age": {
          "value": 0
        },
        "forehead_wrinkle": {
          "value": 0,
          "confidence": 0
        },
        "crows_feet": {
          "value": 0,
          "confidence": 0
        },
        "eye_finelines": {
          "value": 0,
          "confidence": 0
        },
        "glabella_wrinkle": {
          "value": 0,
          "confidence": 0
        },
        "nasolabial_fold": {
          "value": 0,
          "confidence": 0
        },
        "nasolabial_fold_severity": {
          "value": 0,
          "confidence": 0
        },
        "left_mouth_wrinkle_severity": {
          "value": 0
        },
        "right_mouth_wrinkle_severity": {
          "value": 0
        },
        "forehead_wrinkle_severity": {
          "value": 0
        },
        "left_crows_feet_severity": {
          "value": 0
        },
        "right_crows_feet_severity": {
          "value": 0
        },
        "left_eye_finelines_severity": {
          "value": 0
        },
        "right_eye_finelines_severity": {
          "value": 0
        },
        "glabella_wrinkle_severity": {
          "value": 0
        },
        "left_nasolabial_fold_severity": {
          "value": 0
        },
        "right_nasolabial_fold_severity": {
          "value": 0
        },
        "left_cheek_wrinkle_severity": {
          "value": 0
        },
        "right_cheek_wrinkle_severity": {
          "value": 0
        },
        "fine_line": {
          "forehead_count": 0,
          "left_undereye_count": 0,
          "right_undereye_count": 0,
          "left_cheek_count": 0,
          "right_cheek_count": 0,
          "left_crowsfeet_count": 0,
          "right_crowsfeet_count": 0,
          "glabella_count": 0
        },
        "wrinkle_count": {
          "forehead_count": 0,
          "left_undereye_count": 0,
          "right_undereye_count": 0,
          "left_mouth_count": 0,
          "right_mouth_count": 0,
          "left_nasolabial_count": 0,
          "right_nasolabial_count": 0,
          "glabella_count": 0,
          "left_cheek_count": 0,
          "right_cheek_count": 0,
          "left_crowsfeet_count": 0,
          "right_crowsfeet_count": 0
        },
        "forehead_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "forehead_wrinkle_list": []
        },
        "left_eye_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "left_eye_wrinkle_list": []
        },
        "right_eye_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "right_eye_wrinkle_list": []
        },
        "left_crowsfeet_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "left_crowsfeet_wrinkle_list": []
        },
        "right_crowsfeet_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "right_crowsfeet_wrinkle_list": []
        },
        "glabella_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "glabella_wrinkle_list": []
        },
        "left_mouth_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "left_mouth_wrinkle_list": []
        },
        "right_mouth_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "right_mouth_wrinkle_list": []
        },
        "left_nasolabial_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "left_nasolabial_wrinkle_list": []
        },
        "right_nasolabial_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "right_nasolabial_wrinkle_list": []
        },
        "left_cheek_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "left_cheek_wrinkle_list": []
        },
        "right_cheek_wrinkle_info": {
          "wrinkle_score": 0,
          "wrinkle_severity_level": 0,
          "wrinkle_norm_length": 0,
          "wrinkle_norm_depth": 0,
          "wrinkle_pixel_density": 0,
          "wrinkle_area_ratio": 0,
          "wrinkle_deep_ratio": 0,
          "wrinkle_deep_num": 0,
          "wrinkle_shallow_num": 0,
          "right_cheek_wrinkle_list": []
        },
        "cheekbone_mark": {
          "left_cheekbone_mark": [],
          "right_cheekbone_mark": []
        },
        "eye_pouch": {
          "value": 0,
          "confidence": 0
        },
        "eye_pouch_severity": {
          "value": 0,
          "confidence": 0
        },
        "left_eye_pouch_rectangle": [],
        "right_eye_pouch_rectangle": [],
        "dark_circle": {
          "value": 0,
          "confidence": 0
        },
        "dark_circle_severity": {
          "value": 0,
          "confidence": 0
        },
        "left_dark_circle_rete": {
          "value": 0
        },
        "right_dark_circle_rete": {
          "value": 0
        },
        "left_dark_circle_pigment": {
          "value": 0
        },
        "right_dark_circle_pigment": {
          "value": 0
        },
        "left_dark_circle_structural": {
          "value": 0
        },
        "right_dark_circle_structural": {
          "value": 0
        },
        "dark_circle_mark": {
          "left_eye_rect": {
            "left": 0,
            "top": 0,
            "width": 0,
            "height": 0
          },
          "right_eye_rect": {
            "left": 0,
            "top": 0,
            "width": 0,
            "height": 0
          }
        },
        "left_eye_pouch_rect": {
          "left": 0,
          "top": 0,
          "width": 0,
          "height": 0
        },
        "right_eye_pouch_rect": {
          "left": 0,
          "top": 0,
          "width": 0,
          "height": 0
        },
        "wrinkle_mark": {
          "left_cheek_wrinkle_outline": [],
          "right_cheek_wrinkle_outline": [],
          "head_wrinkle_outline": [],
          "left_nasolabial_wrinkle_outline": [],
          "right_nasolabial_wrinkle_outline": [],
          "glabella_wrinkle_outline": [],
          "left_crowsfeet_wrinkle_outline": [],
          "right_crowsfeet_wrinkle_outline": [],
          "left_mouth_wrinkle_outline": [],
          "right_mouth_wrinkle_outline": [],
          "left_eye_wrinkle_outline": [],
          "right_eye_wrinkle_outline": []
        },
        "dark_circle_outline": {
          "left_dark_circle_outline": [],
          "right_dark_circle_outline": []
        },
        "score_info": {
          "dark_circle_score": 0,
          "skin_type_score": 0,
          "wrinkle_score": 0,
          "oily_intensity_score": 0,
          "pores_score": 0,
          "blackhead_score": 0,
          "acne_score": 0,
          "sensitivity_score": 0,
          "melanin_score": 0,
          "water_score": 0,
          "rough_score": 0,
          "total_score": 0,
          "pores_type_score": {
            "pores_forehead_score": 0,
            "pores_leftcheek_score": 0,
            "pores_rightcheek_score": 0,
            "pores_jaw_score": 0
          },
          "dark_circle_type_score": {
            "left_dark_circle_score": 0,
            "right_dark_circle_score": 0
          }
        },
        "enhanced_bw_info": {
          "enhanced_bw_rect": {
            "left": 0,
            "top": 0,
            "width": 0,
            "height": 0
          },
          "ratio": 0
        },
        "face_maps": {
          "red_area": "",
          "brown_area": "",
          "texture_enhanced_pores": "",
          "texture_enhanced_blackheads": "",
          "texture_enhanced_oily_area": "",
          "texture_enhanced_lines": "",
          "water_area": "",
          "rough_area": "",
          "roi_outline_map": "",
          "texture_enhanced_bw": ""
        }
      }
    }

    Code example​

    Last updated on