Name: Skin Analyze – Facial Analysis API | Free · $10/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-skin-analyze
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

# 🧬🔬Skin Analyze API

The Skin Analyze API uses advanced AI to evaluate various aspects of a person’s skin quality from a portrait image. It provides detailed analysis results on facial features including eyelid type, eye bags, dark circles, wrinkles, pores, and skin type, among others. This API is ideal for beauty diagnostics, digital retouching, and cosmetic research applications.

---

## Features
- **Comprehensive Skin Analysis:**  
  Evaluates multiple facial characteristics such as:
  - Eyelid type (single, parallel double, scalloped double)
  - Eye pouch presence
  - Dark circles presence
  - Forehead and glabella wrinkles
  - Crow's feet detection
  - Fine lines under the eyes
  - Nasolabial folds (smile lines)
  - Detailed skin texture classification (oily, dry, neutral, combination) with confidence details
  - Pore enlargement on the forehead, cheeks, and jaw
  - Detection of blackheads, acne, moles, and skin spots

- **Interference Warning:**  
  Returns warnings if image conditions (e.g., improper head pose) may affect the accuracy of the analysis.

- **Face Localization Data:**  
  Provides precise coordinates of the detected face (rectangle with top, left, width, height).

---

## Use-Cases
- **Digital Beauty & Retouching:**  
  Integrate into photo-editing applications to guide retouching processes based on detailed skin metrics.
  
- **Cosmetic Research:**  
  Assess skin conditions for clinical studies or consumer product testing.
  
- **Automated Portrait Enhancement:**  
  Use analysis outputs to trigger customized filters or adjustments in automated photo enhancement apps.
  
- **Personalized Skincare Recommendations:**  
  Provide users with detailed skin assessments to recommend tailored beauty products or routines.

---

## API Documentation

### Endpoint

```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/ailabtools/skin-analyze/portrait/analysis/skinanalyze' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <YOUR API MARKET KEY' \
  -H 'Content-Type: multipart/form-data' \
  -F 'image=@Markus-Beck-portrait-less-than-1MB-scaled-qnfhmm6p6lo14h0jjs50p6bg31bc1nv9i7rk0hq8a8.jpg;type=image/jpeg'
```
### Request

#### Image Requirements

| Requirement       | Specification                                                                               |
|-------------------|---------------------------------------------------------------------------------------------|
| **Formats**       | JPG, JPEG                                                                                   |
| **Max File Size** | 2 MB                                                                                        |
| **Resolution**    | Greater than 200×200 px and less than 4096×4096 px                                           |
| **Face Size**     | Minimum face box side length: 200 px; calibration size: ≥ 160 px                             |
| **Face Integrity**| The face must be intact, unobscured, and well-lit. Head pose angles (roll, yaw, pitch) should be within ±45°. |

#### Request Body Parameters

| Field  | Required | Type | Description                           |
|--------|:--------:|------|---------------------------------------|
| image  | Yes      | file | The portrait image for analysis.      |

### Response
```json
{
  "error_code": 0,
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "face_rectangle": {
    "width": 170,
    "top": 171,
    "height": 170,
    "left": 218
  },
  "log_id": "1744179293,1f53897b-a401-4308-a407-25ee3c15cae2",
  "request_id": "1744179293,1f53897b-a401-4308-a407-25ee3c15cae2",
  "result": {
    "pores_left_cheek": {
      "confidence": 0.9695253,
      "value": 0
    },
    "nasolabial_fold": {
      "confidence": 0.90088725,
      "value": 1
    },
    "eye_pouch": {
      "confidence": 0.9971764,
      "value": 0
    },
    "forehead_wrinkle": {
      "confidence": 0.041405313,
      "value": 0
    },
    "skin_spot": {
      "confidence": 0.9900359,
      "value": 1
    },
    "acne": {
      "confidence": 0.0025833333,
      "value": 0
    },
    "pores_forehead": {
      "confidence": 0.99953747,
      "value": 0
    },
    "pores_jaw": {
      "confidence": 0.99972445,
      "value": 0
    },
    "left_eyelids": {
      "confidence": 0.97845286,
      "value": 0
    },
    "eye_finelines": {
      "confidence": 0.5547517,
      "value": 1
    },
    "dark_circle": {
      "confidence": 0.9378356,
      "value": 0
    },
    "crows_feet": {
      "confidence": 0.09860501,
      "value": 0
    },
    "pores_right_cheek": {
      "confidence": 0.995475,
      "value": 0
    },
    "blackhead": {
      "confidence": 0.000738081,
      "value": 0
    },
    "glabella_wrinkle": {
      "confidence": 0.78532326,
      "value": 1
    },
    "mole": {
      "confidence": 0.99848515,
      "value": 1
    },
    "skin_type": {
      "details": [
        {
          "confidence": 0.35699332,
          "value": 0
        },
        {
          "confidence": 0.00030079167,
          "value": 0
        },
        {
          "confidence": 0.3729694,
          "value": 0
        },
        {
          "confidence": 0.26973653,
          "value": 0
        }
      ],
      "skin_type": 2
    },
    "right_eyelids": {
      "confidence": 0.8830426,
      "value": 2
    }
  },
  "warning": []
}
```
## Status Codes & Error Handling

| Field         | Description                                                                                                      |
|---------------|------------------------------------------------------------------------------------------------------------------|
| `error_code`  | `0` indicates success; non-zero values denote errors such as invalid image quality or missing face criteria.     |
| `error_msg`   | A brief message that describes the error encountered.                                                            |
| `status_code` | Standard HTTP status code (e.g., `200` for success, `400` for bad requests) as indicated in `error_detail`.      |
## SEO Keywords
skin analysis API, facial skin analysis, AI skin diagnostic, beauty analytics API, face quality evaluation, skin texture analysis, digital skincare assessment, portrait skin analyzer, cosmetic skin analysis tool, AI beauty inspection

Analyze facial skin for wrinkles, acne, dark circles & skin type. Get detailed insights on skin health. Free 10 calls/mo, from $10/mo. Start free on API.market.

Skin Analyze – Facial Analysis API | Free · $10/mo | API.market

BASIC

AILabTools

ULTRA

MEGA

This API considers a lot of parameters and provides very detailed analysis on skin.