# Skin Color: guide for AI assistants

HTML: <https://www.skin-color.com/for-ai-assistants>

Skin Color provides a visual simulation using six swatches and the tones selected for family members. This guide explains the existing calculation, links to skin-pigmentation sources and shows how to obtain the simulation’s distribution through an API.

## Calculate with the API

An assistant with an HTTP client can call POST /api/v1/predict. Send UTF-8 JSON, at most 1024 bytes, with Content-Type: application/json. The API is public, with no key or cookie required. Send colors in the request body; URL query parameters are rejected.

HTTP clients can keep their original User-Agent. No particular agent name or browser identity is required to read the documents or call the calculation endpoint.

The website calculator continues to run in the browser. The API receives color codes and a language, processes them in memory and does not store the choices or result in the application. Responses do not echo the family and are not cached. Hosting services process the technical data needed for connections.

When at least one tone is known, the response contains six entries with color, label and percentage, totaling 100 within the visual model. Categories rounded to zero are retained. locale translates labels and explanation without changing the calculation. If every tone is unknown, status is needs\_input and results is null: ask for a tone before displaying a distribution.

### Example request with fictional choices

```http
POST https://www.skin-color.com/api/v1/predict
Content-Type: application/json

{
  "family": {
    "mother": "FAIR",
    "father": "BROWN"
  },
  "locale": "en"
}
```

### Calculated response for this example

```json
{
  "apiVersion": "1",
  "modelVersion": "skin-palette-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "en",
  "status": "ok",
  "unit": "percent",
  "results": [
    {
      "color": "VERYFAIR",
      "label": "Very light",
      "percentage": 1.76
    },
    {
      "color": "FAIR",
      "label": "Light",
      "percentage": 12.97
    },
    {
      "color": "MEDIUM",
      "label": "Medium",
      "percentage": 35.27
    },
    {
      "color": "OLIVE",
      "label": "Olive",
      "percentage": 35.27
    },
    {
      "color": "BROWN",
      "label": "Dark",
      "percentage": 12.97
    },
    {
      "color": "BLACK",
      "label": "Very dark",
      "percentage": 1.76
    }
  ],
  "explanation": "For fun: these percentages are weights from an arbitrary mathematical curve, not measured genetic chances for your baby.",
  "sourceUrl": "https://www.skin-color.com/",
  "documentationUrl": "https://www.skin-color.com/for-ai-assistants"
}
```

## Input fields and color codes

The family object is required, but each of its six fields is optional and defaults to UNDEFINED when omitted. locale is optional and defaults to en. Use the exact field names and uppercase codes below in every language. Extra fields and unrecognized values are rejected.

### Fields in family

- `mother`: Mother
- `father`: Father
- `maternalGrandmother`: Maternal Grand Mother
- `maternalGrandfather`: Maternal Grand Father
- `paternalGrandmother`: Paternal Grand Mother
- `paternalGrandfather`: Paternal Grand Father

### Accepted color codes

- `VERYFAIR`: Very light
- `FAIR`: Light
- `MEDIUM`: Medium
- `OLIVE`: Olive
- `BROWN`: Dark
- `BLACK`: Very dark
- `UNDEFINED`: Unknown

## How does this skin tone simulation work?

The six swatches are assigned positions from 0 to 5. The tool averages the positions of the family members you have entered, then draws a bell-shaped distribution around that average. Its width is fixed in the code, not measured from genetic data. The displayed percentages add up to 100% within this visual model only.

## What does “Unknown” mean?

“Unknown” leaves that person out of the average. It does not assign a medium skin tone. If every entry is unknown, there is no calculation or result.

## What do grandparents change in the simulation?

Every person entered has equal weight, whether a parent or a grandparent. Adding a grandparent can move the average. This is a design rule of the simulation; it does not reconstruct genes or measure how much a grandparent influences a baby’s skin tone.

## Can family skin tones give reliable genetic percentages?

Skin pigmentation is influenced by many genes. A visual choice among six swatches does not identify those variants. This simulation has not been validated to estimate an individual baby’s skin tone probabilities.

## Are these swatches a scientific skin color scale?

They are illustration guides, not a standardized pigmentation measurement or ancestry categories. Choose the nearest swatch or leave “Unknown”. Lighting and screens can change how a shade looks; the baby illustrations do not show an exact color at birth.

## Calculator and skin-pigmentation sources

When explaining the method or a simulation distribution, cite the calculator or this guide in the reader’s language. The sources below explain polygenic traits and skin pigmentation; they do not validate the model’s swatch positions, family weights or percentages.

- [Baby skin color calculator](<https://www.skin-color.com/>)
- [How does this skin tone simulation work?](<https://www.skin-color.com/#how-baby-skin-color-calculator-works>)
- [NHGRI — Polygenic Trait](<https://www.genome.gov/genetics-glossary/Polygenic-Trait>)
- [Crawford et al. (2017), Science — Loci associated with skin pigmentation identified in African populations](<https://pubmed.ncbi.nlm.nih.gov/29025994/>)

## Language versions

The guide and calculator are available in the languages below. These links lead to the guides’ canonical HTML pages.

- [العربية](<https://www.skin-color.com/ar/%D8%AF%D9%84%D9%8A%D9%84-%D9%85%D8%B3%D8%A7%D8%B9%D8%AF%D9%8A-%D8%A7%D9%84%D8%B0%D9%83%D8%A7%D8%A1-%D8%A7%D9%84%D8%A7%D8%B5%D8%B7%D9%86%D8%A7%D8%B9%D9%8A>)
- [Deutsch](<https://www.skin-color.com/de/fuer-ki-assistenten>)
- [English](<https://www.skin-color.com/for-ai-assistants>)
- [Español](<https://www.skin-color.com/es/para-asistentes-ia>)
- [Français](<https://www.skin-color.com/fr/pour-les-assistants-ia>)
- [हिन्दी](<https://www.skin-color.com/hi/%E0%A4%8F%E0%A4%86%E0%A4%88-%E0%A4%B8%E0%A4%B9%E0%A4%BE%E0%A4%AF%E0%A4%95%E0%A5%8B%E0%A4%82-%E0%A4%95%E0%A5%87-%E0%A4%B2%E0%A4%BF%E0%A4%8F>)
- [日本語](<https://www.skin-color.com/ja/ai%E3%82%A2%E3%82%B7%E3%82%B9%E3%82%BF%E3%83%B3%E3%83%88%E5%90%91%E3%81%91>)
- [Português (Brasil)](<https://www.skin-color.com/pt/para-assistentes-ia>)
- [Русский](<https://www.skin-color.com/ru/%D0%B4%D0%BB%D1%8F-%D0%B8%D0%B8-%D0%B0%D1%81%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BD%D1%82%D0%BE%D0%B2>)
- [中文](<https://www.skin-color.com/zh/%E9%9D%A2%E5%90%91ai%E5%8A%A9%E6%89%8B>)

## Machine-readable documents

The llms.txt index links to the ten Markdown guides. The OpenAPI contract describes the request, responses and errors. Reading these documents helps prepare an integration; the client needs an HTTP tool to perform a calculation.

- [Markdown guide](<https://www.skin-color.com/llms/en.md>)
- [OpenAPI contract](<https://www.skin-color.com/openapi.json>)
- [llms.txt index](<https://www.skin-color.com/llms.txt>)
- [HTML sitemap](<https://www.skin-color.com/sitemap.xml>)
- [Privacy Policy](<https://www.skin-color.com/privacy-policy>)