AILabTools API - Skin analyze Pro - API:V1.6.6(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.

Header

Field	Required	Type	Description
ailabapi-api-key	YES	string	Application API KEY. Get API KEY

Body

Field	Required	Type	Scope	Description
image	YES	file		Main Image.
left_side_image	NO	file		Side face picture.(Left)
right_side_image	NO	file		Side face picture.(Right)
return_maps	NO	string	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_marks	NO	string	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_color	NO	json string		Customize the color. More Details
return_side_results	NO	string	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

Field	Description	Return image information
red_area	Red zone map to show areas of redness caused by facial sensitivity and inflammation	A map of the red zone on a white background, with shades of red characterizing the degree of sensitivity.
brown_area	Brown area map to show areas of facial pigmentation	A map of brown areas on a white background, with shades of brown characterizing the degree of chromatophoresis.
texture_enhanced_pores	Facial pore enlargement area map	Transparent background PNG, labeled pore size area, image size is the same as the original image, can be stacked to view.
texture_enhanced_blackheads	Facial blackhead area map	Transparent background PNG, labeled black head area, image size is the same as the original image, can be stacked to view.
texture_enhanced_oily_area	Facial oil shine area map	Transparent background PNG, labeled facial shine area, image size is the same as the original image, can be stacked to view.
texture_enhanced_lines	Facial texture map, mark the more obvious deep lines and light lines on the face	Transparent background PNG, labeled facial wrinkles, image size is the same as the original image, can be stacked to view.
water_area	Facial moisture map, showing facial dehydration areas, the darker the blue color means the more dehydrated the skin is	PNG on white background, labeled facial dehydration area, same image size as the original.
rough_area	Facial roughness map showing the rough areas of the face	Transparent background PNG, labeled facial rough areas, image size is the same as the original image, can be stacked to view.
roi_outline_map	Facial blemishes and acne coordinates mapping	Transparent 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_bw	Facial blackheads & enlarged pores black & white enhancement chart	JPG 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

Field	Description
wrinkle_mark	Facial forehead, nose, crow's feet, cheeks, and contour coordinates of the area between the eyebrows
right_nasolabial_list	Coordinates, depth, and length of the right wrinkle
right_mouth_list	Coordinates, depth, and length of the wrinkles in the right corner of the mouth
right_eye_wrinkle_list	Coordinates, depth, and length of subwrinkles in the right eye area
right_crowsfeet_list	Coordinates, depth and length of crows feet wrinkles on the right eye
right_cheek_list	Right cheek wrinkle pattern, depth and length
left_nasolabial_list	Coordinates, depth, and length of the left legal sub-wrinkle
left_mouth_list	Coordinates, depth and length of wrinkles in the left corner of the mouth
left_eye_wrinkle_list	Coordinates, depth, and length of the left eye subwrinkle
left_crowsfeet_list	Coordinates, depth, and length of crow's feet wrinkles on the left eye
left_cheek_list	Left cheek wrinkle pattern, depth and length
glabella_wrinkle_list	Coordinates, depth, and length of sub-frown lines between eyebrows
forehead_wrinkle_list	Forehead wrinkle coordinates, depth and length
dark_circle_outline	Left and right eye dark circle contour line coordinates
sensitivity_mark	Red zone coordinates, which provide coordinates of red areas caused by facial sensitivity and inflammation
melanin_mark	Area coordinates for hyperpigmented areas of the face
dark_circle_outline	Left and right eye dark circle contour line coordinates
cheekbone_mark	Facial 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

Field	Default	Description
pores_color	0000FF	Pore drawing color
blackhead_color	FF0000	Blackhead drawing color
wrinkle_color	6E9900	Deep grain drawing color
fine_line_color	8DFE2A	Fine line drawing color
closed_comedones_color	00FF00	Closed port drawing color
acne_pustule_color	9F21F6	Pustular papules color
acne_nodule_color	FF00FD	Acne nodules drawing color
acne_color	FE0100	Light papules drawing color
brown_spot_color	7E2A28	Pigmentation 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

Field	Description
jawline_info	The 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

Field	Type	Description
left_side_result	json string	Results of side face analysis. More Details
right_side_result	json string	Results of side face analysis. More Details
face_rectangle	object	Face position. More Details
result	object	Results of face skin analysis. More Details

left_side_result

Field	Type	Scope	Description
+left_jawline_quality	integer	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_angle	float		The angle of the jawline.
+left_jawline_mark	array		Coordinates of jawline face key points.

right_side_result

Field	Type	Scope	Description
+right_jawline_quality	integer	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_angle	float		The angle of the jawline.
+right_jawline_mark	array		Coordinates of jawline face key points.

face_rectangle

Field	Type	Description
+top	float	The vertical coordinate of the pixel point in the upper-left corner of the rectangle box.
+left	float	The horizontal coordinate of the pixel point in the upper-left corner of the rectangle.
+width	float	The width of the rectangle box.
+height	float	The 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

Field	Type	Scope	Description
+image_quality	json string
++face_ratio	float		The proportion of the human face to the whole photo.
++face_orientation	object		Face 3D angle.
+++yaw	float		Yaw angle. The angle of rotation around the Y-axis. It is expressed as the horizontal rotation of the head to the left or right.
+++pitch	float		Pitch angle. The angle of rotation around the X-axis. Expressed as head pitch and tilt.
+++roll	float		Scroll angle. The angle of rotation around the Z axis, expressed as the rotation of the face photo seen from the front.
++face_rect	float		The 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.
+++top	float
+++left	float
+++width	float
+++height	float
++hair_occlusion	float		The proportion of bangs to the human face.
++glasses	integer	0 1	0: No eyeglasses were worn. 1: Wearing eyeglasses.

Skin Type Analysis

Field	Type	Scope	Description
+skin_type	object		Skin texture test results.
++skin_type	integer	0 1 2 3	Type. 0: Oily skin. 1: Dry skin. 2: Neutral skin. 3: Combination skin.
++details	object		The confidence level of each classification.
+++0	object		Oily skin information.
++++value	integer	0 1	Oily skin. 0: No. 1: Yes.
++++confidence	float		Confidence.
+++1	object		Dry skin information.
++++value	integer	0 1	Dry skin. 0: No. 1: Yes.
++++confidence	float		Confidence.
+++2	object		Neutral skin information.
++++value	integer	0 1	Neutral skin. 0: No. 1: Yes.
++++confidence	float		Confidence.
+++3	object		Combination skin information.
++++value	integer	0 1	Combination skin. 0: No. 1: Yes.
++++confidence	float		Confidence.
+oily_intensity	object		Oil output level detection.
++t_zone	object		T-zone.
+++area	object	[0, 1]	Area share.
+++intensity	integer	0 1 2	Severity of oiling. 0: No shine or slight shine. 1: Medium shine phenomenon. 2: Severe oiling.
++left_cheek	object		Left cheek.
+++area	object	[0, 1]	Area share.
+++intensity	integer	0 1 2	Severity of oiling. 0: No shine or slight shine. 1: Medium shine phenomenon. 2: Severe oiling.
++right_cheek	object		Right cheek.
+++area	object	[0, 1]	Area share.
+++intensity	integer	0 1 2	Severity of oiling. 0: No shine or slight shine. 1: Medium shine phenomenon. 2: Severe oiling.
++chin_area	object		Chin area.
+++area	object	[0, 1]	Area share.
+++intensity	integer	0 1 2	Severity of oiling. 0: No shine or slight shine. 1: Medium shine phenomenon. 2: Severe oiling.
+water	object		The percentage of dehydrated skin on the forehead, cheeks and chin, the percentage of overall facial dehydrated area and the severity of dehydration.
++water_severity	float	[0, 100]	Severity of water shortage .
++water_area	float		Percentage of water deficit area .
++water_forehead	object		Percentage of forehead deficiency area.
+++area	float	[0, 1]	Area share.
++water_rightcheek	object		Percentage of dehydrated area on the right cheek.
+++area	float	[0, 1]	Area share.
++water_leftcheek	object		Percentage of dehydrated area on the left cheek.
+++area	float	[0, 1]	Area share.
+skin_tone	object		Skin color test results.
++value	integer	0 1 2 3 4	Skin color. 0: Translucency. 1: Fairness. 2: Natural. 3: Wheat. 4: Tanned/Bronze.
++confidence	float	[0, 1]	Confidence.
+skintone_ita	object		Returns skin color classification information based on the ITA (Individual Typology Angle) standard. NOTE
++ITA	float	[-90, 90]	Angle value.
++skintone	integer	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_ha	object		Returns skin tone classification information based on HA (Hue Angle). NOTE
++HA	float	[0, 90]	HA angle value.
++skintone	integer	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

Field	Type	Scope	Description
+blackhead	object		Blackhead information.
++value	integer	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].
++confidence	float	[0, 1]	Confidence.
+blackhead_count	integer		Number of blackheads on the nose area.
+enlarged_pore_count	object		The number of enlarged pores and the percentage of enlarged pore area.
++forehead	object		Forehead.
+++count	integer		Number of enlarged pores.
+++area	float	[0, 1]	Percentage of enlarged pore area.
++left_cheek_count	object		Left cheek.
+++count	integer		Number of enlarged pores.
+++area	float	[0, 1]	Percentage of enlarged pore area.
++right_cheek_count	object		Right cheek.
+++count	integer		Number of enlarged pores.
+++area	float	[0, 1]	Percentage of enlarged pore area.
++chin_count	object		Chin.
+++count	integer		Number of enlarged pores.
+++area	float	[0, 1]	Percentage of enlarged pore area.
+pores_forehead	object		The severity of enlarged forehead pores.
++value	integer	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].
++confidence	float	[0, 1]	Confidence.
+pores_rightcheek	object		The severity of enlarged pores on the right cheek.
++value	integer	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].
++confidence	float	[0, 1]	Confidence.
+pores_leftcheek	object		The severity of enlarged pores on the left cheek.
++value	integer	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].
++confidence	float	[0, 1]	Confidence.
+pores_jaw	object		The severity of enlarged pores on the chin.
++value	integer	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].
++confidence	float	[0, 1]	Confidence.
+rough	object		Output the percentage of rough skin area on forehead, cheeks and chin, the percentage of overall facial rough area and the severity of roughness.
++rough_severity	integer	[0, 100]	Severity.
++rough_area	float	[0, 1]	Area share.
++rough_forehead	object		Forehead.
+++area	float	[0, 1]	Area share.
++rough_rightcheek	object		Right cheek.
+++area	float	[0, 1]	Area share.
++rough_leftcheek	object		Left cheek.
+++area	float	[0, 1]	Area share.
++rough_jaw	object		Jaw.
+++area	float	[0, 1]	Area share.

Pigmentation

Field	Type	Scope	Description
+melanin	object		Return the skin pigmentation of the human face in the photo.
++brown_area	float	[0, 1]	Percentage of full-face area of pigmented areas.
++melanin_concentration	float	[0, 100]	Degree of pigmentation.
++brown_forehead	float	[0, 1]	Percentage of forehead hyperpigmentation area.
++brown_rightcheek	float	[0, 1]	Percentage of hyperpigmented area on the right cheek.
++brown_leftcheek	float	[0, 1]	Percentage of hyperpigmented area on the left cheek.
+melanin_mark	object		Information on the pigmented areas of the brown area map.
++polygon	array		A 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
++++x	float
++++y	float
+mole	Object		Information for each mole area.
++rectangle	array		The position of each mole frame.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++confidence	array		The confidence level of each mole region.
++polygon	array		Within 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
++++x	float
++++y	float
+brown_spot	Object		Information for each discolored area.
++rectangle	array		The position of each color spot box.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++confidence	array		Confidence level for each chromatophore region.
++polygon	array		A 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
++++x	float
++++y	float
+melasma	Object		Melasma information.
++value	integer	0 1	0: No melasma. 1: There is melasma.
++confidence	float		Confidence.
+freckle	Object		Freckle information.
++value	integer	0 1	0: No freckles. 1: There are freckles.
++confidence	float		Confidence.

Acne Analysis

Field	Type	Scope	Description
+acne	Object		Acne 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.
++rectangle	array		The location of each papule box.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++confidence	array		Confidence level of each papule box.
++polygon	array		Within 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
++++x	float
++++y	float
+acne_pustule	Object		Acne 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.
++rectangle	array		The location of each pustule box.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++confidence	array		Confidence level of each pustule box.
++polygon	array		The 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
++++x	float
++++y	float
+acne_nodule	Object		Acne 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.
++rectangle	array		The position of each nodal box.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++confidence	array		The confidence level of each nodal box.
++polygon	array		Within 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
++++x	float
++++y	float
+acne_mark	Object		Red 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.
++rectangle	array		The location of each pockmark box.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++confidence	array		Confidence level of each pockmark box.
++polygon	array		A 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
++++x	float
++++y	float
+closed_comedones	Object		Rectangular boxes and more detailed polygonal boxes for each occlusive acne area.
++rectangle	array		The location of each closed-cell acne box.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++confidence	array		Confidence level of each closed-jaw acne box.
++polygon	array		A 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
++++x	float
++++y	float

Sensitivity Analysis

Field	Type	Scope	Description
+sensitivity	object		The 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_area	float	[0, 1]	The percentage of sensitive skin area on the whole face. Sensitive redness areas include cheeks, T-zone, etc.
++sensitivity_intensity	float	[0, 100]	The intensity of redness in sensitive areas.
+sensitivity_mark	object		The location of the polygon box in the sensitive muscle area of the red zone diagram.
++polygon	array		The 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
++++x	float
++++y	float

Senescence analysis

Field	Type	Scope	Description
+skin_age	object		Skin age test results.
++value	integer	[0, 100]	Skin age.
+forehead_wrinkle	object		Results of the head lift test.
++value	integer	0 1	0: No head lines. 1: There are head lines.
++confidence	float	[0, 1]	Confidence.
+crows_feet	object		Crow's feet test results.
++value	integer	0 1	0: No crow's feet. 1: With crow's feet.
++confidence	float	[0, 1]	Confidence.
+eye_finelines	object		Results of the eye fine lines test.
++value	integer	0 1	0: No fine lines under the eyes. 1: With fine lines under the eyes.
++confidence	float	[0, 1]	Confidence.
+glabella_wrinkle	object		Results of the interbrow line test.
++value	integer	0 1	0: No interbrow lines. 1: With interbrow lines.
++confidence	float	[0, 1]	Confidence.
+nasolabial_fold	object		Results of the forehead line test.
++value	integer	0 1	0: No lines. 1: There are lines.
++confidence	float	[0, 1]	Confidence.
+nasolabial_fold_severity	object		Severity of the forehead lines. Returned when [nasolabial_fold=1].
++value	integer	0 1 2	0: Mild. 1: Moderate. 2: Severe.
++confidence	float	[0, 1]	Confidence.
+left_mouth_wrinkle_severity	object		The presence & severity of marionette lines on the left side of the face.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_mouth_wrinkle_severity	object		The presence & severity of marionette lines on the right side of the face.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+forehead_wrinkle_severity	object		The severity of the headline. Returned when [forehead_wrinkle=1].
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+left_crows_feet_severity	object		The presence & severity of crow's feet on the left side of the face.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_crows_feet_severity	object		The presence & severity of crow's feet on the right side of the face.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+left_eye_finelines_severity	object		The presence & severity of fine lines under the eyes on the left side of the face.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_eye_finelines_severity	object		The presence & severity of fine lines under the eyes on the right side of the face.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+glabella_wrinkle_severity	object		The presence & severity of fine lines between the eyebrows.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+left_nasolabial_fold_severity	object		The presence or absence & severity of the left facial lines.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_nasolabial_fold_severity	object		The presence or absence & severity of right facial lines.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+left_cheek_wrinkle_severity	object		The presence & severity of left cheek lines.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_cheek_wrinkle_severity	object		The presence & severity of right cheek lines lines.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+fine_line	object		Number of fine lines detected.
++forehead_count	integer		Forehead.
++left_undereye_count	integer		Fine lines in the left eye.
++right_undereye_count	integer		Fine lines in the right eye.
++left_cheek_count	integer		Left cheek.
++right_cheek_count	integer		Right cheek.
++left_crowsfeet_count	integer		Crow's feet in the left eye.
++right_crowsfeet_count	integer		Crow's feet in the right eye.
++glabella_count	integer		Interbrow lines.
+wrinkle_count	object		Number of deep grain detection.
++forehead_count	integer		Forehead.
++left_undereye_count	integer		Fine lines in the left eye.
++right_undereye_count	integer		Fine lines in the right eye.
++left_cheek_count	integer		Left cheek.
++right_cheek_count	integer		Right cheek.
++left_crowsfeet_count	integer		Crow's feet in the left eye.
++right_crowsfeet_count	integer		Crow's feet in the right eye.
++glabella_count	integer		Interbrow lines.
++left_mouth_count	integer		Puppet pattern at the left corner of the mouth.
++right_mouth_count	integer		Puppet pattern at the right corner of the mouth.
++left_nasolabial_count	integer		The left legal line.
++right_nasolabial_count	integer		The right wrinkle.
+forehead_wrinkle_info	object		Number of deep grain detection.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+left_eye_wrinkle_info	object		Left eye wrinkle information.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+right_eye_wrinkle_info	object		Right eye wrinkle information.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+left_crowsfeet_wrinkle_info	object		Left fishtail information.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+right_crowsfeet_wrinkle_info	object		Right fishtail information.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+glabella_wrinkle_info	object		Information on the lines between the eyebrows.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+left_mouth_wrinkle_info	object		Information on the left corner of the mouth tattoo.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+right_mouth_wrinkle_info	object		Information on the right corner of the mouth tattoo.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+left_nasolabial_wrinkle_info	object		Information about the left legal line.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+right_nasolabial_wrinkle_info	object		Information on the right-hand wrinkle.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+left_cheek_wrinkle_info	object		Left face wrinkle information.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+right_cheek_wrinkle_info	object		Right face wrinkle information.
++wrinkle_score	integer	[0, 100]	Wrinkle score.
++wrinkle_severity_level	integer	0 1 2 3	Wrinkle severity level. 0: None. 1: Mild. 2: Moderate. 3: Severe.
++wrinkle_norm_length	float		Wrinkle-normalized length.
++wrinkle_norm_depth	float		Wrinkle normalized depth.
++wrinkle_pixel_density	float		Wrinkle pixel density.
++wrinkle_area_ratio	float	[0, 1]	Percentage of wrinkled area.
++wrinkle_deep_ratio	float	[0, 1]	Percentage of deep grain length.
++wrinkle_deep_num	integer		Number of deep lines.
++wrinkle_shallow_num	integer		Number of shallow lines.
++forehead_wrinkle_list	array		Sub-wrinkle information.
+++wrinkle_coord	array		Subwrinkle pixel coordinates.
++++x	float
++++y	float
+++wrinkle_coord	float		Sub-wrinkle depth.
+++wrinkle_length	float		Subwrinkle length.
+cheekbone_mark	object		Information about the coordinates of the left apple muscle and the coordinates of the right apple muscle.
++left_cheekbone_mark	array		Left apple muscle coordinates.
+++x	float
+++y	float
++left_cheekbone_mark	array		Right apple muscle coordinates.
+++x	float
+++y	float

Eye Analysis

Field	Type	Scope	Description
+eye_pouch	object		Eye bag test results.
++value	integer	0 1	0: No bags under the eyes. 1: With bags under the eyes.
++confidence	float		Confidence.
+eye_pouch_severity	object		Severity of eye bags. Return when [eye_pouch.value=1].
++value	integer	0 1 2	0: Mild. 1: Moderate. 2: Severe.
++confidence	float		Confidence.
+left_eye_pouch_rectangle	array		The position of the left eye bag frame
++width	float		Width.
++height	float		Height.
++left	float		The distance from the leftmost part of the picture.
++top	float		The distance from the topmost edge of the image.
+right_eye_pouch_rectangle	array		The position of the right eye bag frame
++width	float		Width.
++height	float		Height.
++left	float		The distance from the leftmost part of the picture.
++top	float		The distance from the topmost edge of the image.
+dark_circle	object		Dark eye circle type detection.
++value	integer	0 1 2 3	0: No dark circles under the eyes. 1: Pigmented dark circles. 2: Vascular dark circles. 3: Dark circles with shadows.
++confidence	float		Confidence.
+dark_circle_severity	object		Severity of dark circles under the eyes. Return when [dark_circle.value <> 1].
++value	integer	0 1 2	0: Mild. 1: Moderate. 2: Severe.
++confidence	float		Confidence.
+left_dark_circle_rete	object		Severity of vascular type dark circles under the left eye.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_dark_circle_rete	object		Severity of vascular type dark circles under the right eye.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+left_dark_circle_pigment	object		Severity of pigmented dark circles under the left eye.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_dark_circle_pigment	object		Severity of pigmented dark circles under the right eye.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+left_dark_circle_structural	object		Severity of structural dark circles under the left eye..
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+right_dark_circle_structural	object		Severity of structural dark circles under the right eye.
++value	integer	0 1 2 3	0: None. 1: Mild. 2: Moderate. 3: Severe.
+dark_circle_mark	object		The position of the rectangular box coordinates of the black eye.
++left_eye_rect	object		Left eye.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++right_eye_rect	object		Right eye.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
+left_eye_pouch_rect	object		Left eye bag rectangular box position.
++width	float		Width.
++height	float		Height.
++left	float		The distance from the leftmost part of the picture.
++top	float		The distance from the topmost edge of the image.
+right_eye_pouch_rect	object		Right eye bag rectangular box position.
++width	float		Width.
++height	float		Height.
++left	float		The distance from the leftmost part of the picture.
++top	float		The distance from the topmost edge of the image.
+wrinkle_mark	object		Wrinkle contour line coordinates.
++left_eye_wrinkle_outline	array		Wrinkles in the left eye.
+++x	float
+++y	float
++right_eye_wrinkle_outline	array		Wrinkles in the Right eye.
+++x	float
+++y	float
++left_cheek_wrinkle_outline	array		Wrinkles on the left side of the face.
+++x	float
+++y	float
++right_cheek_wrinkle_outline	array		Wrinkles on the right side of the face.
+++x	float
+++y	float
++glabella_wrinkle_outline	array		Interbrow lines.
+++x	float
+++y	float
++left_nasolabial_wrinkle_outline	array		The left legal line.
+++x	float
+++y	float
++right_nasolabial_wrinkle_outline	array		The right legal line.
+++x	float
+++y	float
++left_crowsfeet_wrinkle_outline	array		Left fishtail line..
+++x	float
+++y	float
++right_crowsfeet_wrinkle_outline	array		Right fishtail line..
+++x	float
+++y	float
++left_mouth_wrinkle_outline	array		Left corner of the mouth tattoo.
+++x	float
+++y	float
++right_mouth_wrinkle_outline	array		Right corner of the mouth tattoo.
+++x	float
+++y	float
++head_wrinkle_outline	array		Forehead wrinkles.
+++x	float
+++y	float
+dark_circle_outline	object		Dark eye contour coordinates.
++left_dark_circle_outline	array		Left eye.
+++x	float
+++y	float
++right_dark_circle_outline	array		Right eye.
+++x	float
+++y	float

Overall Score

Field	Type	Scope	Description
+score_info	object		Score. Degree & Score
++dark_circle_score	integer	[0, 100]	Dark Circles Total Score
++skin_type_score	integer	[0, 100]	Skin Quality Score
++wrinkle_score	integer	[0, 100]	Wrinkle Score
++oily_intensity_score	integer	[0, 100]	Oily Score
++pores_score	integer	[0, 100]	Total Pore Score
++blackhead_score	integer	[0, 100]	Blackheads Score
++acne_score	integer	[0, 100]	Acne Score
++sensitivity_score	integer	[0, 100]	Sensitivity Score
++melanin_score	integer	[0, 100]	Melanin Score
++water_score	integer	[0, 100]	Skin Moisture Score
++rough_score	integer	[0, 100]	Skin Roughness Score
++total_score	integer	[0, 100]	Total Score
++pores_type_score	object		Pore Score
+++pores_forehead_score	integer	[0, 100]	Forehead Pore Score
+++pores_leftcheek_score	integer	[0, 100]	Left Cheek Pore Score
+++pores_rightcheek_score	integer	[0, 100]	Right Cheek Pore Score
+++pores_jaw_score	integer	[0, 100]	Jaw Pore Score
++dark_circle_type_score	object		Dark Circles Score
+++left_dark_circle_score	integer	[0, 100]	Left Eye Dark Circle Score
+++right_dark_circle_score	integer	[0, 100]	Right Eye Dark Circle Score

Customization

Field	Type	Scope	Description
+enhanced_bw_info	object		Black and white enhanced map coordinates location. Conversion formula
++enhanced_bw_rect	object		Black and white enhanced graph coordinate frame.
+++width	float		Width.
+++height	float		Height.
+++left	float		The distance from the leftmost part of the picture.
+++top	float		The distance from the topmost edge of the image.
++ratio	float		Crop ratio.
+face_maps	object		Skin problem detection mapping picture. Returns information based on the return_maps field input.
++red_area	base64		More Details
++brown_area	base64		More Details
++texture_enhanced_pores	base64		More Details
++texture_enhanced_blackheads	base64		More Details
++texture_enhanced_oily_area	base64		More Details
++texture_enhanced_lines	base64		More Details
++water_area	base64		More Details
++rough_area	base64		More Details
++roi_outline_map	base64		More Details
++texture_enhanced_bw	base64		More 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.

skintone	Scope	Description
0	56 < ITA < 90	Very light.
1	43 < ITA <= 56	Light.
2	36 < ITA <= 43	Intermediate.
3	20 < ITA <= 36	Tan.
4	10 < ITA <= 20	Brown.
5	-90 < ITA <= 10	Dark.
6	Other	Abnormal 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.

skintone	Scope	Description
0	49 < HA <= 90	Yellowish.
1	46 <= HA < 49	Neutral.
2	10 <= HA < 46	Reddish.
3	Other	Abnormal 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.

Skin Analysis Cases

Portraits
Results	Result	Result	Result	Result

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

• Introduction
• Code example