Skip to main content
POST
Skin Analyze Pro

Cases

Authorizations

ailabapi-api-key
string
header
required

API Key for authentication

Body

multipart/form-data
image
file
required

Main Image.

  • Image format: JPEG JPG
  • 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.
left_side_image
file

Side face picture.(Left)

  • Image format: JPEG JPG
  • 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 = 45°, pitch ≤ ±40° recommended), etc.
right_side_image
file

Side face picture.(Right)

  • Image format: JPEG JPG
  • 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 = 45°, pitch ≤ ±40° recommended), etc.
return_maps
string

Specifies the skin analysis map types to return. Multiple values can be provided as a comma-separated list. See return_maps.

Example:

"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,right_roi_outline_map,left_roi_outline_map"

return_marks
string

Specifies the problem area marks to return, including coordinates and related information. Multiple values can be provided as a comma-separated list. See return_marks.

Example:

"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"

roi_outline_color
string
default:{"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"}

Specifies the colors used to highlight problem areas in the image returned by return_maps. See roi_outline_color.

return_side_results
string

Specifies the side profile analysis results to return. A side profile image must be provided in the request. Multiple values can be provided as a comma-separated list. See return_side_results.

Example:

"jawline_info"

Response

200 - application/json

Success

request_id
string
required

Request ID for debugging.

log_id
string
required

Log ID for debugging.

error_detail
object
required
face_rectangle
object

Position of the face rectangle box.

left_side_result
object

Results of the left side-profile analysis. See details.

right_side_result
object

Results of the right side-profile analysis. See details.

result
object

Results of the facial skin analysis. See details.