Skin analysis
8.9 / 10
2,289ms
97%
100%
README
This API is no longer maintained, please consider carefully whether to continue using it; or you can use another version of Skin Analysis to replace it.
Our Skin Analysis API offers a comprehensive solution for detailed multi-dimensional skin analysis, providing precise detection and recognition of various skin attributes. This API can accurately assess skin tone, smoothness, acne scars, wrinkles, pores, blackheads, dark circles, and eye bags, including specific details such as vascular dark circles and acne marks. Ideal for dermatologists, skincare brands, and beauty tech developers, this tool delivers in-depth skin evaluations, helping users understand and address their skincare needs. Integrate our Skin Analysis API into your application to offer users a powerful and precise skin analysis tool, enabling personalized skincare recommendations and treatments based on comprehensive skin assessments. Enhance your platform with advanced skin analysis technology, ensuring high-quality, accurate results for all users.
-
Skin color detection: skin color detection on the face in the picture, supports 1-6 blocks, the smaller the number, the lighter the color
-
Skin smoothness detection: the skin smoothness detection of the face in the picture, supports 1-4 gears, the smaller the number, the smoother the skin
-
Pimple spot detection: detect all kinds of acne (acne, acne marks, nodules), spots (chloasma, freckles, sunburn, age spots), moles on face pictures,
-
Wrinkle detection: It can detect all kinds of wrinkles in the face (forehead wrinkles, Sichuan character lines, fine lines around the eyes, crow’s feet, nasolabial lines, and perioral lines), and subdivide the contour coordinates of each wrinkle.
-
Dark circles and eye bags detection: high-precision detection of dark circles (pigment type, shadow type, blood vessel type) and eye bags (fat type, tear groove type, mixed type) around the eyes of the face
-
Blackhead pore detection: detect blackheads in the nose area (fat plug, silk type, mite type) and obvious pores in the forehead and cheek areas (shiny type, dehydrated type, keratin type, aging type)
-
Skin health detection: detect the face visa image array, and return the gray image, brown image, and red image
-
Dry oil tolerance analysis: analyze the dry and oily skin of the forehead, nose, left face, right face, and chin area, and detect the overall skin sensitivity tolerance
Application scenarios
-
Skin management: Record the daily analysis results and care records of the skin in the health management software, form a skin care diary, help users or businesses record changes in the skin condition of customers, and track skin care effects.
-
Cosmetics marketing: The online skincare & cosmetics marketing page provides targeted skincare effect demonstrations, providing interesting gameplay and experience.
-
Smart medical beauty: In the medical cosmetology scene, it provides analysis and self-diagnosis before medical cosmetology, provides analysis data of skin condition, and provides reference for product selection.
Technical advantages
-
Comprehensive testing: The skin condition can be analyzed comprehensively and meticulously from more than 10 dimensions, showing professional and accurate skin problems.
-
Accurate results: It can provide professional-level skin detection accuracy, accurately mark millimeter-level skin blemishes, and all kinds of skin problems can be seen at a glance.
-
Stable service: It can provide enterprise-level stable and accurate high-traffic services, with millisecond-level recognition and response capabilities and 99.9% reliability guarantee.
Request Parameters
| Field | Type | Scope | Description |
|---|---|---|---|
image |
file | - | |
max_face_num |
int | 1 - 10 | The maximum number of faces that can be processed. The default value is 1 (only the face with the largest area in the picture is detected); the maximum value is 10. |
face_field |
string | - | Including [color, smooth, acnespotmole, wrinkle, eyesattr, blackheadpore, skinface, skinface, skinquality] information, separated by commas, and the order can be changed. By default, only [face_token, location] is returned. |
Response Parameters
| Field | Type | Description |
|---|---|---|
face_num |
int | The number of faces in the picture |
face_list |
array | See below for face information list field information |
face_token |
string | Face logo |
location |
array | The position of the face in the picture |
+left |
double | The distance of the face area from the left border |
+top |
double | The distance of the face area from the upper boundary |
+width |
double | The width of the face area |
+height |
double | The height of the face area |
+degree |
int | The clockwise rotation angle of the face frame relative to the vertical direction, [-180,180] |
skin |
array | Skin related information |
+color |
int | Skin tone grading, 1~6, the smaller the skin tone, the lighter the skin tone |
+smooth |
int | Skin smoothness grading, 1~4, the smaller the smoother |
acnespotmole |
array | Information about mole spots |
+acne_num |
int | Number of acne detected |
+acne_list |
array | Acne list |
+++type |
int | Acne type, the value range is 0-3. [0: Whitehead; 1: Acne mark; 2: Pustules; 3: Nodules] |
+++score |
double | The confidence range for this area is 0~1 |
+++left |
double | The distance between the left border of the acne area and the left border of the picture |
+++top |
double | The distance between the upper border of the acne area and the upper border of the picture |
+++right |
double | The distance between the right border of the acne area and the left border of the picture |
+++bottom |
double | The distance between the bottom border of the acne area and the top border of the picture |
+speckle_num |
int | Number of spots |
+speckle_list |
array | Spot information list |
+++type |
int | Spot type, the value range is 0-3. [0: chloasma chloasma; 1: freckles freckle; 2: sunburn sunburn; 3: age spots agespot] |
+++score |
double | The confidence range of this area is 0~1 |
+++left |
double | The distance between the left border of the spot area and the left border of the picture |
+++top |
double | The distance between the upper border of the spot area and the upper border of the picture |
+++right |
double | The distance between the right border of the spot area and the left border of the picture |
+++bottom |
double | The distance between the bottom border of the spot area and the top border of the picture |
+mole_num |
int | Number of moles |
+mole_list |
array | Mole information list |
+++score |
double | This area is the confidence range of moles 0~1 |
+++left |
double | The distance between the left border of the mole area and the left border of the picture |
+++top |
double | The distance between the upper border of the mole area and the upper border of the picture |
+++right |
double | The distance between the right border of the mole area and the left border of the picture |
+++bottom |
double | The distance between the lower border of the mole area and the upper border of the picture |
wrinkle |
array | Wrinkle information |
+wrinkle_num |
int | Number of wrinkles |
+wrinkle_types |
int | Wrinkle types: 1 forehead wrinkles, 2 Sichuan-shaped lines, 3 fine lines around the eyes, 4 crow’s feet, 5 nasolabial lines, 6 wrinkles around the mouth |
+wrinkle_data |
array | Wrinkle information |
+++x |
double | The distance from the wrinkle point to the left border |
+++y |
double | The distance between the wrinkle point and the upper boundary |
eyesattr |
array | Eye attribute information |
+dark_circle_left_type |
int | Types of dark circles in the left eye: 0 pigment type, 1 shadow type, 2 vascular type |
+dark_circle_right_type |
int | Types of dark circles in the right eye: 0 pigment type, 1 shadow type, 2 vascular type |
+dark_circle_left |
array | Dark circles on the left eye |
+++x |
double | The distance of the dark circle from the left border |
+++y |
double | The distance of the dark circle from the upper boundary |
+dark_circle_right |
array | Dark circles on the right eye |
+++x |
double | The distance of the dark circle from the left border |
+++y |
double | The distance of the dark circle from the upper boundary |
+eye_bags_left |
array | Left eye bag |
+++x |
double | The distance of the eye bag from the left border |
+++y |
double | The distance between the bags under the eyes and the upper boundary |
+eye_bags_right |
array | Right eye bag |
+++x |
double | The distance of the eye bag from the left border |
+++y |
double | The distance between the bags under the eyes and the upper boundary |
+eye_bags_left_type |
array | Left eye bag type: 1 Fat type 2 Tear groove type 3 Mixed type |
+eye_bags_right_type |
array | Types of bags under the right eye: 1 Fat type 2 Tear groove type 3 Mixed type |
blackheadpore |
array | Blackhead pore information |
+poly |
array | Areas where blackhead pores are detected |
+++class_id |
int | Blackhead or pore identification (0 means blackhead, 1 means pore) |
+++score |
double | Probability (0-1) |
+++left |
double | The location of the left boundary of the area |
+++right |
double | Location of the right boundary of the area |
+++top |
double | The location of the upper boundary of the area |
+++bottom |
double | The location of the lower boundary of the area |
+++point |
array | Outer contour points of pores or blackheads |
+++++x |
double | The distance of the pore or blackhead from the left border |
+++++y |
double | The distance of the pores or blackheads from the upper boundary |
+circles |
array | Center point and radius of pores or blackheads |
+++blackhead |
array | Center point and radius of all blackheads |
+++++x |
double | The distance from the center point of the black head to the left boundary |
+++++y |
double | The distance from the center point of the black head to the upper boundary |
+++++r |
double | Blackhead radius |
+++pore |
array | Center point and radius of all pores |
+++++x |
double | The distance between the center point of the pore and the left boundary |
+++++y |
double | The distance between the center point of the pore and the upper boundary |
+++++r |
double | Pore radius |
+pore_num |
int | Number of pores |
+pore_segs_type |
array | Pore type: 1 is oily type 2 is dehydrated type 3 is keratinous type 4 is aging type |
+blackhead_num |
int | Number of blackhead spots |
+blackhead_segs_type |
array | Blackhead type: 1 is fat plug type 2 is fat silk type 3 is mite type |
skinface |
array | Skin health test |
+skin_health_check_images |
array | Skin health detection face visa image array, base64 array |
++src_pic |
string | Original image BASE64 string |
++gray_pic |
string | Gray image picture BASE64 string |
++brown_pic |
string | Brown picture picture BASE64 string |
++red_pic |
string | Red picture image BASE64 string |
skinquality |
array | Analysis of Tolerance of Dry Skin Oil |
+skin_dryoil_check |
array | Array of dry and oily skin fields, example: [“0”,“1”,“0”,“0”,“0”],//“0”:“dry”,“1”:“neutral”, “2”: “oily”, which represents the forehead, nose, left cheek, right cheek, and chin in order. |
+skin_sensitive_check |
array | Array of skin tolerance fields, example: [“2”] // “0”: “tolerance”, “1”: “neutral”, “2”: “sensitive” |
