> For the complete documentation index, see [llms.txt](https://docs.saas.haut.ai/haut.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.saas.haut.ai/haut.ai/developers.md). # For Developers - [Authentication and Token Management](https://docs.saas.haut.ai/haut.ai/developers/authentication-and-token-management.md): How to authenticate against the Haut.AI API with a JWT bearer token, manage your API keys, and handle an expired or invalid key. - [Pagination](https://docs.saas.haut.ai/haut.ai/developers/pagination.md): How to page through large Haut.AI API responses with the page and page\_size query parameters, and what the response returns. - [Errors](https://docs.saas.haut.ai/haut.ai/developers/errors.md): The error format the Haut.AI API returns, the validation, client, and server error types you can hit, and how to handle each. - [SaaS API Overview](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview.md): Overview of the Haut.AI SaaS API: endpoints for datasets, algorithms, subjects, and product recommendations, plus how deprecation works. - [API for Datasets](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-datasets.md): This page contains description of datasets management via API. - [API for CSV Export from Dataset](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-datasets/api-for-csv-export-from-dataset.md): This page contains description how to manage CSV exports via API. - [API for Body Datasets](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-datasets/api-for-body-datasets.md): The full API flow for body analysis: create a body dataset and subject, attach the application, upload an image, and collect results. - [API for Algorithm Applications](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-algorithm-applications.md): This page contains description of algorithms applications management via API. - [API for Face Metrics 2.0](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0.md): API reference for Face Metrics 2.0: the algorithms included, the generic response scheme, and how to fetch metrics, submetrics, and masks. - [Generic Algorithm Metric Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/output-overview.md): This page explains the output of the API - [Acne Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/acne.md): Haut.AI provides an AI algorithm that estimates acne-like spots for different facial areas and the whole face. - [Eye Age Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/eye-age.md): Haut.AI provides an AI algorithm that estimates the age in years of a particular face based on the eye area only. - [Eye Area Condition Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/eye-bags-eye-circles-and-lacrimal-grooves.md): Haut.AI provides a set of AI algorithms that estimate the condition of the skin in the eye area. - [Hydration Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/hydration.md): Result scheme for the Hydration algorithm in Face Metrics 2.0: the area, main metric, sub-metric, and mask fields, with a JSON example. - [ITA (Individual Typology Angle) Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/skintone.md): Haut.AI provides a computer vision algorithm that evaluates the skin tone of different facial areas and the whole face. - [Lines Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/wrinkles.md): Haut.AI provides an AI algorithm that estimates lines-like objects in different facial areas and the whole face. - [Perceived Age Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/age.md): Haut.AI provides an AI algorithm that estimates the age in years of a particular face. - [Pigmentation Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/pigmentation.md): Haut.AI provides an AI algorithm that estimates pigmented spots for different facial areas and the whole face. - [Pores Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/pores.md): Haut.AI provides an AI algorithm that estimates pores in different facial areas and the whole face. - [Redness Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/redness.md): Haut.AI provides AI algorithms that analyze the overall skin redness and skin irritation for different facial areas and for the whole face. - [Skin tone Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/skintone_classification.md): Haut.AI provides an AI algorithm that evaluates the skin tone - [Skin type Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/skin-type-result-scheme.md): Result scheme for the Skin type algorithm in Face Metrics 2.0: the area and mask fields, and the four classes the main metric returns. - [Uniformness Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/uniformness.md): Haut.AI provides AI algorithms that analyze the skin uniformness of different facial areas and the whole face. - [Technical Algorithms Results](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/technical-algorithms-results.md): Response schemes for the technical algorithms in Face Metrics 2.0, including the image quality results returned alongside skin parameters. - [Image Quality Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/technical-algorithms-results/image-quality.md): How the image quality algorithm scores a selfie, and the quality properties, problems, and feedback fields it returns. - [Facial Hair Attributes Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/technical-algorithms-results/facial-hair-attributes-result-scheme.md): Haut.AI provides an AI algorithm that segments facial hair of different types. - [Facial Landmarks Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/technical-algorithms-results/facial-landmarks.md): Result scheme for the Facial Landmarks algorithm in Face Metrics 2.0, which returns a vectorized mask of 53 predefined face points. - [Deprecated Algorithms Response Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/deprecated-algorithms-response-scheme.md): Response schemes for the deprecated Face Metrics 2.0 algorithms, kept for reference while you migrate to Face Skin Analysis 3.0. - [Sagging Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/deprecated-algorithms-response-scheme/sagging.md): Haut.AI provides an AI algorithm that evaluates the condition of nasolabial folds. - [Translucency Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/deprecated-algorithms-response-scheme/translucency.md): Haut.AI provides an AI algorithm that evaluates skin luminosity. - [Wrinkles Response Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-metrics-2.0/deprecated-algorithms-response-scheme/wrinkles.md): Haut.AI provides an AI algorithm that estimates wrinkles in different facial areas and the whole face. - [API for Face Skin Analysis 3.0](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0.md): API reference for Face Skin Analysis 3.0: the parameters it covers and how to fetch scores, masks, and predicted images after calculation. - [API for Images](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/api-for-images.md): How to upload photos to Haut.AI over the API, send an image batch for computation, and fetch the results per algorithm application. - [Predicted images](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/api-for-images/predicted-images.md): This page contains a description of how to get predicted images via the API for the Face Skin Analysis 3.0 - [API for Masks](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/api-for-images/api-for-masks.md): How to retrieve detection masks from the Face Skin Analysis 3.0 Results API, which image to pair each mask with, and how to render SVG and PNG overlays. - [Visualize masks in Flutter](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/api-for-images/visualize-masks-in-flutter.md): Flutter example for overlaying a Face Skin Analysis 3.0 SVG mask on its matching face image, with a runnable DartPad playground. - [Best practices](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/api-for-images/best-practices.md): How to build a Face Skin Analysis 3.0 integration that tolerates new algorithms appearing in the results, with Python, JavaScript, and TypeScript examples. - [Move to the Face Skin Analysis 3.0 Upload Flow](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/move-to-the-face-skin-analysis-3.0-upload-flow.md): A plain-language walkthrough for moving photo uploads and results from the old API to Face Skin Analysis 3.0. - [Migrate from Face Skin Metrics 2.0 to Face Skin Analysis 3.0](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/migrate-from-face-skin-metrics-2.0-to-face-skin-analysis-3.0.md): What changed between Face Skin Metrics 2.0 and Face Skin Analysis 3.0, and how to migrate your integration to the new version. - [Breakouts Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/breakouts.md): Result scheme for the Breakouts parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, and mask fields, with a JSON example. - [Acne Inflammation Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/breakouts/acne-inflammation.md): Result scheme for the Acne Inflammation parameter in the Face Skin Analysis 3.0 API: the algorithm, grade, density, area, and mask fields. - [Pimples Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/breakouts/pimples.md): Result scheme for the Pimples parameter in the Face Skin Analysis 3.0 API: the algorithm, grade, amount, area, and mask fields. - [Papules Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/breakouts/papules.md): Result scheme for the Papules parameter in the Face Skin Analysis 3.0 API: the algorithm, grade, amount, area, and mask fields. - [Pustules Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/breakouts/pustules.md): Result scheme for the Pustules parameter in the Face Skin Analysis 3.0 API: the algorithm, grade, amount, area, and mask fields. - [Post-acne Hyperpigmentation Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/breakouts/post-acne-hyperpigmentation.md): Result scheme for the Post-acne Hyperpigmentation parameter in the Face Skin Analysis 3.0 API: the algorithm, grade, density, area, and mask fields. - [Dark Circles Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/dark-circles.md): Result scheme for the Dark Circles parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, area, and mask fields. - [Eyes Age Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/eyes-age.md): Result scheme for the Eyes Age parameter in the Face Skin Analysis 3.0 API: the algorithm, eyes\_age, and area fields, with a JSON example. - [Under Eye Puffiness Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/under-eye-puffiness.md): Result scheme for the Under Eye Puffiness parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, and mask fields. - [ITA Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/ita.md): Result scheme for the ITA parameter in the Face Skin Analysis 3.0 API: the ita value, L, a and b channels, classification, and area fields. - [Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines.md): Result scheme for the Lines parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, areas, and mask fields. - [Deep Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/deep-lines.md): Result scheme for the Deep Lines parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, area, and mask fields. - [Fine Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/fine-lines.md): Result scheme for the Fine Lines parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, area, and mask fields. - [Forehead Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/forehead-lines.md): Result scheme for the Forehead Lines parameter in the Face Skin Analysis 3.0 API, including the deep and fine line counts, lengths, and masks. - [Lip Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/lip-lines.md): Result scheme for the Lip Lines parameter in the Face Skin Analysis 3.0 API, including the deep and fine line counts, lengths, and masks. - [Marionette Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/marionette-lines.md): Result scheme for the Marionette Lines parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, and mask fields. - [Nasolabial Wrinkles Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/nasolabial-wrinkles.md): Result scheme for the Nasolabial Wrinkles parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, and mask fields. - [Glabellar Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/glabellar-lines.md): Result scheme for the Glabellar Lines parameter in the Face Skin Analysis 3.0 API, including the deep and fine line counts, lengths, and masks. - [Under Eye Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/under-eye-lines.md): Result scheme for the Under Eye Lines parameter in the Face Skin Analysis 3.0 API, including the deep and fine line counts, lengths, and masks. - [Crow's Feet Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/crow-s-feet-lines.md): Result scheme for the Crow's Feet Lines parameter in the Face Skin Analysis 3.0 API, including the deep and fine line counts, lengths, and masks. - [Eye Lines Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/lines/eye-lines.md): Result scheme for the Eye Lines parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, mask, amount, and length fields. - [Perceived Age Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/perceived-age.md): Result scheme for the Perceived Age parameter in the Face Skin Analysis 3.0 API, which returns the algorithm and a single age value. - [Pigmentation Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/pigmentation.md): Result scheme for the Pigmentation parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, and mask fields, with a JSON example. - [Freckles Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/pigmentation/freckles.md): Result scheme for the Freckles parameter in the Face Skin Analysis 3.0 API: the algorithm, density, area, and mask fields. - [Moles Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/pigmentation/moles.md): Result scheme for the Moles parameter in the Face Skin Analysis 3.0 API: the algorithm, amount, area, and mask fields. - [Melasma Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/pigmentation/melasma.md): Result scheme for the Melasma parameter in the Face Skin Analysis 3.0 API: the algorithm, density, area, and mask fields. - [Sun Spots Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/pigmentation/sun-spots.md): Result scheme for the Sun Spots parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, density, area, and mask fields. - [Pores Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/pores.md): Result scheme for the Pores parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, amount, and area fields. - [Enlarged Pores Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/pores/enlarged-pores.md): Result scheme for the Enlarged Pores parameter in the Face Skin Analysis 3.0 API: the algorithm, amount, area, and mask fields. - [Redness Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/redness.md): Result scheme for the Redness parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, and mask fields, with a JSON example. - [Irritation Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/redness/irritation.md): Result scheme for the Irritation parameter in the Face Skin Analysis 3.0 API, which returns the algorithm, a grade, and a score. - [Sagging Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/sagging.md): Result scheme for the Sagging parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, and mask fields, with a JSON example. - [Jowls Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/sagging/jowls.md): Result scheme for the Jowls parameter in the Face Skin Analysis 3.0 API, which returns the algorithm, a tag, and a grade. - [Lacrimal Grooves Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/sagging/lacrimal-grooves.md): Result scheme for the Lacrimal Grooves parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, score, grade, and mask fields. - [Skin Type Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/skin-type.md): Result scheme for the Skin Type parameter in the Face Skin Analysis 3.0 API: the algorithm, classification, and area fields. - [Skin Tone Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/skin-tone.md): Result scheme for the Skin Tone parameter in the Face Skin Analysis 3.0 API, which returns the algorithm and a tone classification. - [Uniformness Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/uniformness-parameter-result-scheme.md): Result scheme for the Uniformness parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, area, and mask fields. - [Hydration Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/hydration.md): Result scheme for the Hydration parameter in the Face Skin Analysis 3.0 API: the algorithm, tag, grade, score, and mask fields. - [Quality Parameter Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-face-skin-analysis-3.0/quality.md): Result scheme for the Quality parameter in the Face Skin Analysis 3.0 API, which returns the algorithm and an image quality result. - [API for Pigmentation Pro](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-pigmentation-pro.md): Use this app to analyse pigmentation conditions. The algorithm distinguishes between 4 different pigmentation manifestations, such as freckles, moles, solar and age spots, melasma-like. - [Freckles Results Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-pigmentation-pro/freckles-results-scheme.md): Result scheme for the Freckles algorithm in the Pigmentation Pro API: the density metric it returns and the mask it produces. - [Moles Results Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-pigmentation-pro/moles-results-scheme.md): Result scheme for the Moles algorithm in the Pigmentation Pro API: the metric it returns and the mask it produces. - [Melasma Results Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-pigmentation-pro/melasma-results-scheme.md): Result scheme for the Melasma algorithm in the Pigmentation Pro API: the density metric it returns and the mask it produces. - [Solar Pigmentation Results Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-pigmentation-pro/solar-pigmentation-results-scheme.md): Result scheme for the Solar Pigmentation algorithm in the Pigmentation Pro API: the density metric it returns and the mask it produces. - [API for Acne Pro](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-acne-pro.md): Use this application to analyze acne conditions. The algorithm distinguishes between 4 different acne manifestations, such as papules, pustules, acne inflammation and post-acne hyperpigmentation. - [Acne Class Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-acne-pro/acne-class-result-scheme.md): Result scheme for the Acne Class algorithm in the Acne Pro API: how to filter for it, how to confirm the calculation succeeded, and why it returns no masks. - [Acne Inflammation Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-acne-pro/acne-inflammation-result-scheme.md): Result scheme for the Acne Inflammation algorithm in the Acne Pro API: how to filter for it, check the calculation, and read its vectorised masks. - [Papules Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-acne-pro/papules-result-scheme.md): Result scheme for the Papules algorithm in the Acne Pro API: how to filter for it, check the calculation, and read its vectorised masks. - [Post-inflammatory Hyperpigmentation Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-acne-pro/post-inflammatory-hyperpigmentation-result-scheme.md): Result scheme for the Post-inflammatory Hyperpigmentation algorithm in the Acne Pro API: filtering, checking the calculation, and reading its masks. - [Pustules Result Scheme](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-acne-pro/pustules-result-scheme.md): Result scheme for the Pustules algorithm in the Acne Pro API: how to filter for it, check the calculation, and read its vectorised masks. - [API for Recommendation System 2.0](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-recommendation-system-2.0.md): The Recommendation System 2.0 application API returns recommendations as a routine to address user's identified skin conditions. - [API for Recommendation System 1.0 (deprecated)](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-recommendation-system-1.0-deprecated.md): The Recommendation Engine application API returns cosmetics products for conditions within three main skincare groups: basic care, eye care, and additional care. - [Care Groups](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-recommendation-system-1.0-deprecated/care-groups.md): Care groups contain the results of the skincare categories according to the rules set in the Face Skin Metrics 2.0 application algorithms. - [Products](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-recommendation-system-1.0-deprecated/products.md): Products includes recommended cosmetics products based on the results of the skincare categories. - [API for Products Recommendation 1.0 (deprecated)](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-products-recommendation-1.0-deprecated.md): This page contains description how to fetch products recommendation via API. - [API for Hair Metrics 2.0](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0.md): Use the Hair app to analyze hair color, uniformness, curliness, frizziness, hair volume, hair length, and hair condition metrics. - [Hair Segmentation](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/hair-segmentation.md): Haut.AI provides an AI algorithm that returns a hair mask and segmented hair images. - [Frizziness](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/frizziness.md): Haut.AI provides an AI algorithm that estimates hair's frizziness level. Response scheme for Hair Metrics 2.0. - [Curliness](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/curliness.md): Haut.AI provides an AI algorithm that estimates hair curliness. Response scheme for Hair Metrics 2.0. - [Density](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/density.md): Haut.AI provides an AI algorithm that estimates the level of hair density. - [Color Uniformness](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/color-uniformness.md): Haut.AI provides an AI algorithm that estimates the level of uniformness in hair color. Response scheme for Hair Metrics 2.0. - [Coloring](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/coloring.md): Haut.AI provides an AI algorithm that estimates hair coloring. - [Length](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/length.md): Haut.AI provides an AI algorithm that estimates hair length. Response scheme for Hair Metrics 2.0. - [Volume](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/volume.md): Haut.AI provides an AI algorithm that estimates hair volume. Response scheme for Hair Metrics 2.0. - [Color](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/color.md): Result scheme for the hair Color metric in Hair Metrics 2.0: the area, main metric, sub-metric, and mask fields it returns. - [Deprecated Version 1.0](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0.md): Response schemes for the deprecated Hair Metrics 1.0 application, kept for reference while you migrate to Hair Metrics 2.0. - [Frizziness](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/frizziness.md): Haut.AI provides an AI algorithm that estimates hair's frizziness level. Response scheme for the deprecated Hair Metrics 1.0. - [Hair Color](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/hair-color.md): Haut.AI provides an AI algorithm that estimates hair color. - [Hair Color Uniformness](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/hair-color-uniformness.md): Haut.AI provides an AI algorithm that estimates the level of uniformness in hair color. Response scheme for the deprecated Hair Metrics 1.0. - [Hair Length](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/hair-length.md): Haut.AI provides an AI algorithm that estimates hair length. Response scheme for the deprecated Hair Metrics 1.0. - [Hair Curliness](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/hair-curliness.md): Haut.AI provides an AI algorithm that estimates hair curliness. Response scheme for the deprecated Hair Metrics 1.0. - [Hair Volume](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/hair-volume.md): Haut.AI provides an AI algorithm that estimates hair volume. Response scheme for the deprecated Hair Metrics 1.0. - [API for Beautification (deprecated)](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/beautification-application.md): Use this application to beautify the selfie by improving the skin condition or adding makeup. The app has three different modes. - [API for Subjects](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-subjects.md): This page contains description of subjects management via API. - [API for Images](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-images.md): This page contains description of images management via API. - [API for Aux Images](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-images/api-for-aux-images.md): Description of aux images management via API. - [API for SVG Masks](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-images/api-for-svg-masks.md): How to receive Algorithm Masks visualized as SVG images. - [API for Masks](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-images/api-for-masks.md): This page contains description how to get images with applied masks via API. - [API for Metrics and Submetrics](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-metrics-and-submetrics.md): This page contains overview and OpenAPI specs of methods used to retrieve metrics and submetrics from SaaS in different scenarios. - [API for Products Recommendation 2.0](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-products-recommendation-2.0.md): Example JSON from the Product Recommendation 2.0 API, showing the user tags, featured products, and recommended products it returns. - [API for PDF report](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-pdf-report.md): This page contains description how to download a PDF report via API. - [API for Webhooks](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-webhooks.md): This page describe how to manage Webhooks via API. - [Webhooks v3](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-webhooks-v3.md): Real-time batch result notifications via the Webhooks v3 API. - [API for SkinGPT](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-skingpt.md): API reference for SkinGPT: manage effects and effect levels, upload images for simulation, and retrieve the generated images. - [Dynamic Prompts Request Example](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-skingpt/dynamic-prompts-request-example.md): Example request that passes dynamic prompts to SkinGPT through the app\_args key when sending an image batch for computation. - [Effect Level Management](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-skingpt/effect-level-management.md): Effect Level is a part of Effect and every request should include Effect ID as a path argument. - [Effects Management](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-skingpt/effects-management.md): API reference for managing SkinGPT effects: create, read, update, duplicate, bulk delete, and attach or detach an effect from a dataset. - [Parameters of Simulations](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-skingpt/parameters-of-simulations.md): Every parameter the SkinGPT API accepts for a simulation, from redness and acne to age shift, UV index, weight, and hair graying. - [API for Product Inventory](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-product-inventory.md): Learn how to create products, organize them into shelves, and manage your Product Inventory through the Haut.AI SaaS API. - [Manage Product Items](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-product-inventory/manage-product-items.md): Create and maintain Product Items in your Haut.AI Product Inventory through the SaaS API. - [Manage Product Shelves](https://docs.saas.haut.ai/haut.ai/developers/saas-api-overview/api-for-product-inventory/manage-product-shelves.md): Create Product Shelves and organize Product Items through the Haut.AI SaaS API. - [API Breaking and Non-breaking Changes Guide](https://docs.saas.haut.ai/haut.ai/developers/api-breaking-and-non-breaking-changes-guide.md): What counts as a breaking change to a Haut.AI API response, what does not, and how to build an integration that survives both. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.saas.haut.ai/haut.ai/developers.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.