API for Face Skin Analysis 3.0

API reference for Face Skin Analysis 3.0: the parameters it covers and how to fetch scores, masks, and predicted images after calculation.

Face Skin Analysis 3.0 Application provides Algorithms that perform the analysis of skin visual appearance on the facial area. The analysis is aimed at evaluating the visible and measurable skin condition parameters.

For a product-level overview, see Face Analysis 3.0 on haut.ai.

Read this page to learn more about the application: Face Skin Analysis 3.0

---

List of Included Algorithms

• Breakouts

  • Acne Inflammation

  • Pimples

  • Papules

  • Pustules

  • Post-acne Hyperpigmentation

• Dark Circles

• Eyes Age

• Under Eye Puffiness

• ITA

• Lines

  • Deep Lines

  • Fine Lines

  • Forehead Lines

  • Lip Lines

  • Marionette Lines

  • Nasolabial Wrinkles

  • Glabellar Lines

  • Under Eye Lines

  • Crow's Feet Lines

  • Eye Lines

• Perceived Age

• Pigmentation

  • Freckles

  • Moles

  • Melasma

  • Sun Spots

• Pores

  • Enlarged Pores

• Redness

  • Irritation

• Sagging

  • Jowls

  • Lacrimal Grooves

• Skin Type

• Skin Tone

• Uniformness

• Hydration

• Quality

---

API to receive Parameters, Masks and Predicted Images after calculation

Please visit the API for Images for detailed description of API methods.

Results are returned per batch:

GET /api/v4/companies/{company_id}/batches/{image_batch_id}/results/

Analysis output sits under the face_skin_analysis_3 key, alongside batch_id, subject_id and dataset_id at the root of the response. Inside face_skin_analysis_3 you get the calculation status in all_algorithms_calculated, side-specific detection_errors, optional predicted_images, and the calculated algorithm outputs under parameters.

Basic and Advanced parameters

Face Skin Analysis 3.0 parameters are split into two sets, and which set you receive depends on your plan. Advanced parameters are omitted from the response entirely when they are not enabled for your company — if a parameter you expect is missing, check this first.

Basic — always returned:

age · breakouts · dark_circles · eyes_age · hydration · lines · pigmentation · pores · puffiness · quality · redness · sagging · skin_type · skintone · uniformness

Advanced — returned only when Advanced metrics are enabled:

crows_feet_deep_lines · crows_feet_fine_lines · crows_feet_lines · deep_lines · enlarged_pores · eyes_lines · fine_lines · forehead_deep_lines · forehead_fine_lines · forehead_lines · freckles · glabellar_deep_lines · glabellar_fine_lines · glabellar_lines · inflammation · irritation · ita · jowls · lacrimal_grooves · lip_deep_lines · lip_fine_lines · lip_lines · marionette_lines · melasma · moles · nasolabial_wrinkles · papules · pimples · post_acne_hyperpigmentation · pustules · sun_spots · under_eye_deep_lines · under_eye_fine_lines · under_eye_lines

Contact your account manager to enable Advanced parameters.

Example response (JSON)

face_skin_analysis_3.0_response_example.json

41KB

Open

---

Not a Haut.AI client yet?

Book a demo Face Skin Analysis 3.0 on haut.ai