> 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/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/hair-color.md).
# Hair Color
Haut.AI provides an AI algorithm that estimates hair color.
## **Description**
This metric describes the hair’s color. All natural hair colors are the result of two pigments: eumelanin and pheomelanin. Generally, if more melanin is present, the color of the hair is darker; if less melanin is present, the hair color is lighter.
**`"algorithm_tech_name": "color"`**
## `area_name`
The algorithm returns metrics for the following area:
* `hair`
## `main_metric`
The main metric indicates the hair color category for `area_name`
```javascript
"main_metric": {
"value": "Brown",
"widget_type": "category",
"name": "Hair Color",
"tech_name": "hair_color",
"widget_meta": null
},
```
* **`value`** The hair color is divided into six classes, as listed below. Each category gets its own confidence level in the range of `[0,100]`, where the highest score indicates the hair color class:
* `Brown`
* `Blond`
* `Black`
* `Red`
* `Gray or White`
* `Other`
* `"widget_type": "category"`
* `"name": "Hair Color"`
* `"tech_name": "hair_color"`
## `sub_metrics`
The algorithm returns six types of sub-metrics: `Black Color Confidence`,`Brown Color Confidence`, `Blond Color Confidence`, `Gray or White Color Confidence`, `Red Color Confidence` and `Other Color Confidence`.
```javascript
"sub_metrics": [
{
"value": 0,
"widget_type": "numeric",
"name": "Black Color Confidence",
"tech_name": "black_color_confidence",
"widget_meta": null
},
{
"value": 83,
"widget_type": "numeric",
"name": "Brown Color Confidence",
"tech_name": "brown_color_confidence",
"widget_meta": null
},
{
"value": 1,
"widget_type": "numeric",
"name": "Blond Color Confidence",
"tech_name": "blond_color_confidence",
"widget_meta": null
},
{
"value": 0,
"widget_type": "numeric",
"name": "Gray or White Color Confidence",
"tech_name": "gray or white_color_confidence",
"widget_meta": null
},
{
"value": 33,
"widget_type": "numeric",
"name": "Red Color Confidence",
"tech_name": "red_color_confidence",
"widget_meta": null
},
{
"value": 0,
"widget_type": "numeric",
"name": "Other Color Confidence",
"tech_name": "other_color_confidence",
"widget_meta": null
}
]
```
* **`Black Color Confidence`** evaluates black color's confidence level
* **`value`** of the black color confidence level ranges from `[0,100]`*. A higher score is associated with a higher chance of the hair being black in color*
* `"widget_type": "numeric"`
* `"name": "Black Color Confidence"`
* `"tech_name": "black_color_confidence"`
* **`Brown Color Confidence`** evaluates brown color's confidence level
* **`value`** of the brown color confidence level ranges from `[0,100]`*. A higher score is associated with a higher chance of the hair being brown in color*
* `"widget_type": "numeric"`
* `"name": "Brown Color Confidence"`
* `"tech_name": "brown_color_confidence"`
* **`Blond Color Confidence`** evaluates blond color's confidence level
* **`value`** of the blond color confidence level ranges from `[0,100]`*. A higher score is associated with a higher chance of the hair being blond in color*
* `"widget_type": "numeric"`
* `"name": "Blond Color Confidence"`
* `"tech_name": "blond_color_confidence"`
* **`Gray or White Color Confidence`** evaluates gray color confidence level
* **`value`** of the gray and white color confidence level ranges from `[0,100]`*. A higher score is associated with a higher chance of the hair being gray or white in color*
* `"widget_type": "numeric"`
* `"name": "Gray or White Color Confidence"`
* `"tech_name": "gray or white_color_confidence"`
* **`Red Color Confidence`** evaluates red color's confidence level
* **`value`** of the red color confidence level ranges from `[0,100]`*. A higher score is associated with a higher chance of the hair being red in color*
* `"widget_type": "numeric"`
* `"name": "Red Color Confidence"`
* `"tech_name": "red_color_confidence"`
* **`Other Color Confidence`** evaluates other colors' confidence level
* **`value`** of the "other" color confidence level ranges from `[0,100]`*. A higher score is associated with a higher chance of the hair being "other" in color*
* `"widget_type": "numeric"`
* `"name": "Other Color Confidence"`
* `"tech_name": "other_color_confidence"`
## `masks_restored`
**None** **-** there are no restored masks for hair color
## `masks_original`
**None -** there are no original masks for hair color
## **Example (JSON)**
{% file src="/files/-MgFU\_xT3by7NMu-sDcU" %}
***
{% hint style="warning" %}
Not a Haut.AI client yet?
{% endhint %}
Book a demo Platform overview on haut.ai
---
# 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/saas-api-overview/api-for-hair-metrics-2.0/deprecated-version-1.0/hair-color.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.