> ## Documentation Index
> Fetch the complete documentation index at: https://ailabtools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Skin Analyze Pro
> Skin Analyze Pro API analyzes skin texture, tone, wrinkles, acne, spots, eye bags, and other facial skin conditions.
## OpenAPI
````yaml /docs/openapi.json post /api/portrait/analysis/skin-analysis-pro
openapi: 3.0.0
info:
title: AILabAPI
description: >-
[AILabTools](https://www.ailabtools.com) is an advanced tool that
offers a vast array of simple and flexible API endpoints to suit your
specific needs. With just one [API
KEY](https://www.ailabtools.com/doc/get-api-key), you can easily call
any of the endpoints and integrate them quickly into your application or
workflow, allowing for smooth and efficient operations.
[AILabTools](https://www.ailabtools.com) is continuously evolving,
and you can anticipate even more API endpoints being added in the future,
further enhancing its capabilities and usefulness for your artificial
intelligence and machine learning requirements.
version: 1.0.0
servers:
- url: https://www.ailabapi.com
description: Production server
security:
- apiKeyAuth: []
tags:
- name: AI IMAGE
- name: AI IMAGE > Image Enhancement
- name: AI IMAGE > Image Effects
- name: AI IMAGE > Image Editing
- name: AI IMAGE > Image Scoring
- name: AI BACKGROUND REMOVAL
- name: AI BACKGROUND REMOVAL > Portrait
- name: AI BACKGROUND REMOVAL > General
- name: AI PORTRAIT
- name: AI PORTRAIT > Portrait Effects
- name: AI PORTRAIT > Portrait Enhance
- name: AI PORTRAIT > Portrait Editing
- name: AI PORTRAIT > Portrait Analysis
- name: AI COMMON
paths:
/api/portrait/analysis/skin-analysis-pro:
post:
tags:
- AI PORTRAIT > Portrait Analysis
summary: Skin Analyze Pro
description: >-
Skin Analyze Pro API analyzes skin texture, tone, wrinkles, acne, spots,
eye bags, and other facial skin conditions.
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
image:
type: string
format: binary
description: Main Image.
left_side_image:
type: string
format: binary
description: Side face picture.(Left)
right_side_image:
type: string
format: binary
description: Side face picture.(Right)
return_maps:
type: string
description: >-
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.
return_marks:
type: string
description: >-
The type of skin problem detection mapping image to be
returned. Use commas to separate multiple types.
roi_outline_color:
type: string
description: Customize the color.
return_side_results:
type: string
description: >-
The side face information that needs to be returned. Use
commas to separate multiple types.
responses:
'200':
headers:
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
request_id: ''
log_id: ''
error_detail:
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: ''
description: Success
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: ailabapi-api-key
description: API Key for authentication
````