Skin Analyze API

Analyze facial skin conditions in images with our Skin Analyze API, detecting skin color, texture, wrinkles, acne, dark circles, and more.

The Skin Analyze API offers a sophisticated solution for assessing facial skin conditions from images. Utilizing advanced image processing technology, this API detects and analyzes various skin attributes, including skin color, texture, double eyelids, eye bags, dark circles, wrinkles, acne, and spots. Ideal for skincare apps, beauty platforms, and dermatology tools, the Skin Analyze API provides detailed insights into skin health and condition, empowering users to make informed skincare decisions. Integrate our high-performance, scalable, and user-friendly API to enhance user engagement, deliver personalized skincare recommendations, and elevate your digital beauty solutions. Experience seamless integration and exceptional accuracy with the Skin Analyze API, designed to meet the evolving needs of modern skincare analysis.

Application Scenarios

Smart Beauty Analysis
Recommended Beauty Products

Featured Advantages

Rich analysis dimension
Comprehensive coverage of skin characteristics
Numerical analysis of findings

Function List

Functions	Description	Corresponding parameters
Face Detection	Detect face and position	`face_rectangle`
Skin Analysis	Analyze skin condition. With or without blackheads With or without acne With or without mole With or without spots With or without eye bags With or without dark circles under the eyes With or without headline With or without crow's feet With or without fine lines under the eyes With or without interbrow lines With or without lines Left and right eyelids (single eyelid, parallel eyelid, scalloped eyelid) Skin type (oily skin, dry skin, normal skin, combination skin) Forehead pores Left cheek pore Right cheek pore Chin Pores	`result`

API Documentation

Endpoints

Skin Analyze

Analyze facial skin conditions in images with our Skin Analyze API, detecting skin color, texture, wrinkles, acne, dark circles, and more.

Request

Image requirements

Image format: JPG JPEG
Image size: No more than 2 MB.
Image resolution: Larger than 200x200px, smaller than 4096x4096px.
Minimum face pixel size: To ensure the effect, it is recommended that the minimum value of the face box (square) side length in the image is not less than 200 pixels. Calibration size: minimum of 160 pixels. The minimum value of the face frame edge length is not less than one-tenth of the shortest edge of the image.
Face quality: The higher the face quality, the more accurate the skin analysis. Factors affecting face quality include: occlusion of the five facial features, blurred images, improper lighting (bright, dark, backlight), excessive face angle (roll ≤ ±45°, yaw ≤ ±45°, pitch ≤ ±45° are recommended), etc.

Body

Field	Required	Type
`image`	YES	`file`

Response

Public Parameters

Viewing Public Parameters and Error Codes

Business Parameters

Field	Type	Scope	Description
`warning`	`array`	`imporper_headpose`	Interference factors affecting the calculation results. `imporper_headpose`: Improper head angle (Judgment condition roll,yaw,pitch exceeds [-45,45]).
`face_rectangle`	`object`		The position of the face rectangle box.
+`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`	`object`		Results of face skin analysis.
+`left_eyelids`	`object`		Results of the double eyelid test on the left eye.
++`value`	`integer`	`0` `1` `2`	Type. `0`: Single eyelids `1`: Parallel Double Eyelids `2`: Scalloped Double Eyelids
++`confidence`	`float`	[0, 1]	Confidence.
+`right_eyelids`	`object`		Results of the double eyelid test on the right eye.
++`value`	`integer`	`0` `1` `2`	Type. `0`: Single eyelids `1`: Parallel Double Eyelids `2`: Scalloped Double Eyelids
++`confidence`	`float`	[0, 1]	Confidence.
+`eye_pouch`	`object`		Eye bag test results.
++`value`	`integer`	`0` `1`	With or without eye bags. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`dark_circle`	`object`		Dark circles test results.
++`value`	`integer`	`0` `1`	With or without dark circles under the eyes. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`forehead_wrinkle`	`object`		Results of the head-lift test.
++`value`	`integer`	`0` `1`	With or without headlines. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`crows_feet`	`object`		Fishtail test results.
++`value`	`integer`	`0` `1`	With or without crow's feet. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`eye_finelines`	`object`		Results of the eye fine lines test.
++`value`	`integer`	`0` `1`	The presence or absence of fine lines under the eyes. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`glabella_wrinkle`	`object`		Results of the interbrow line test.
++`value`	`integer`	`0` `1`	With or without interbrow lines. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`nasolabial_fold`	`object`		Results of the forehead line test.
++`value`	`integer`	`0` `1`	With or without lines. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`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.
+`pores_forehead`	`object`		Forehead pore test results.
++`value`	`integer`	`0` `1`	With or without enlarged pores. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`pores_left_cheek`	`object`		Results of the left cheek pore test.
++`value`	`integer`	`0` `1`	With or without enlarged pores. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`pores_right_cheek`	`object`		Results of the right cheek pore test.
++`value`	`integer`	`0` `1`	With or without enlarged pores. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`pores_jaw`	`object`		Chin pore test results.
++`value`	`integer`	`0` `1`	With or without enlarged pores. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`blackhead`	`object`		Blackhead test results.
++`value`	`integer`	`0` `1`	With or without blackheads. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`acne`	`object`		Acne test results.
++`value`	`integer`	`0` `1`	With or without Acne. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`mole`	`object`		Mole test results.
++`value`	`integer`	`0` `1`	With or without moles. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.
+`skin_spot`	`object`		Spot detection results.
++`value`	`integer`	`0` `1`	With or without spotting. `0`: No `1`: Yes
++`confidence`	`float`	[0, 1]	Confidence.

                                                                            
POST https://zylalabs.com/api/4441/skin+analyze+api/5454/skin+analyze

Skin Analyze - Endpoint Features

Object	Description
`Request Body`	[Required] File Binary

Test Endpoint

API EXAMPLE RESPONSE

       
                                                                                                        
                                                                                                                                                                                                                            {
  "request_id":     "",
  "log_id":         "",
  "error_code":     0,
  "error_code_str": "",
  "error_msg":      "",
  "error_detail":   {
    "status_code":  200,
    "code":         "",
    "code_message": "",
    "message":      ""
  },
  "warning": [],
  "face_rectangle": {
    "top": 0,
    "left": 0,
    "width": 0,
    "height": 0
  },
  "result": {
    "left_eyelids": {
      "value": 0,
      "confidence": 0.89
    },
    "right_eyelids": {
      "value": 0,
      "confidence": 0.89
    },
    "eye_pouch": {
      "value": 0,
      "confidence": 0.89
    },
    "dark_circle": {
      "value": 0,
      "confidence": 0.89
    },
    "forehead_wrinkle": {
      "value": 0,
      "confidence": 0.89
    },
    "crows_feet": {
      "value": 0,
      "confidence": 0.89
    },
    "eye_finelines": {
      "value": 0,
      "confidence": 0.89
    },
    "glabella_wrinkle": {
      "value": 0,
      "confidence": 0.89
    },
    "nasolabial_fold": {
      "value": 0,
      "confidence": 0.89
    },
    "skin_type": {
      "skin_type": 0,
      "details": {
        "0": {
          "value": 1,
          "confidence": 0.89
        },
        "1": {
          "value": 1,
          "confidence": 0.89
        },
        "2": {
          "value": 1,
          "confidence": 0.89
        },
        "3": {
          "value": 1,
          "confidence": 0.89
        }
      }
    },
    "pores": {
      "value": 0,
      "confidence": 1
    },
    "pores_forehead": {
      "value": 0,
      "confidence": 1
    },
    "pores_left_cheek": {
      "value": 0,
      "confidence": 1
    },
    "pores_right_cheek": {
      "value": 0,
      "confidence": 1
    },
    "pores_jaw": {
      "value": 0,
      "confidence": 1
    },
    "blackhead": {
      "value": 0,
      "confidence": 1
    },
    "acne": {
      "value": 0,
      "confidence": 1
    },
    "mole": {
      "value": 0,
      "confidence": 1
    },
    "skin_spot": {
      "value": 0,
      "confidence": 1
    }
  }
}

Skin Analyze - CODE SNIPPETS


    curl --location 'https://zylalabs.com/api/4441/skin+analyze+api/5454/skin+analyze' \
    --header 'Content-Type: application/json' \ 
    --form 'image=@"FILE_PATH"'

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Skin Analyze API REST API, simply include your bearer token in the Authorization header.

Headers

Header	Description
`Authorization`	[Required] Should be `Bearer access_key`. See "Your API Access Key" above when you are subscribed.

Simple Transparent Pricing

No long term commitments. One click upgrade/downgrade or cancellation. No questions asked.