Predict hair color logoPREDICT HAIR
Калькулятор цвета волос

Predict Hair: руководство для ИИ-ассистентов

Predict Hair — игра, моделирующая цвет волос по цветам, выбранным для родителей, бабушек и дедушек. Это руководство объясняет правила калькулятора, приводит источники о пигментации и показывает, как получать результаты игры через API.

Руководство в Markdown

Расчёт через API

Ассистент с HTTP-клиентом может вызвать POST /api/v1/predict. Отправьте JSON в UTF-8 размером не более 1024 байт с Content-Type: application/json. API общедоступен, ключ и cookie не требуются. Цвета передаются в теле запроса; параметры URL отклоняются.

HTTP-клиенты могут сохранять свой исходный User-Agent. Для чтения документов и вызова расчёта не требуется указывать определённое имя агента или представляться браузером.

Калькулятор сайта по-прежнему работает в браузере. API получает коды цветов и язык, обрабатывает их в памяти и не сохраняет выбор или результат в приложении. Ответ не повторяет сведения о семье и не кэшируется. Хостинг обрабатывает технические данные, необходимые для соединений.

Если известен хотя бы один цвет, ответ содержит пять записей с полями color, label и percentage, в сумме дающих 100 в рамках игры. locale меняет язык названий и пояснения, но не расчёт. Если все цвета неизвестны, status равен needs_input, а results — null: запросите один цвет вместо того, чтобы придумывать распределение.

Пример запроса с вымышленными данными

POST https://www.predict-hair.com/api/v1/predict
Content-Type: application/json

{
  "family": {
    "mother": "BROWN",
    "father": "BLOND"
  },
  "locale": "ru"
}
Рассчитанный ответ для этого примера
{
  "apiVersion": "1",
  "modelVersion": "hair-game-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "ru",
  "status": "ok",
  "unit": "percent",
  "results": [
    {
      "color": "BLACK",
      "label": "Черный",
      "percentage": 0
    },
    {
      "color": "BROWN",
      "label": "Шатен",
      "percentage": 57.14
    },
    {
      "color": "RED",
      "label": "Рыжий",
      "percentage": 14.29
    },
    {
      "color": "BLOND",
      "label": "Блонд",
      "percentage": 23.81
    },
    {
      "color": "STBLOND",
      "label": "Очень светлый блонд",
      "percentage": 4.76
    }
  ],
  "explanation": "Игровая симуляция: проценты описывают правила модели, а не реальные шансы ребёнка. Расчёт не определяет гены или цвет волос при рождении.",
  "sourceUrl": "https://www.predict-hair.com/ru",
  "documentationUrl": "https://www.predict-hair.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"
}

Поля и коды запроса

Объект family обязателен, но каждое из его шести полей можно опустить: тогда используется UNDEFINED. Поле locale необязательно, его значение по умолчанию — en. Во всех языках используйте точные имена полей и коды в верхнем регистре из таблиц ниже. Лишние поля и неизвестные значения отклоняются.

Поля объекта family
motherМать
fatherОтец
maternalGrandmotherБабушка по матери
maternalGrandfatherДедушка по матери
paternalGrandmotherБабушка по отцу
paternalGrandfatherДедушка по отцу
Допустимые коды цветов
BLACKЧерный
BROWNШатен
REDРыжий
BLONDБлонд
STBLONDОчень светлый блонд
UNDEFINEDНеизвестно

Правила калькулятора

Игра использует пять категорий с фиксированным приоритетом: чёрный, коричневый, рыжий, светлый и очень светлый. Она сочетает условные профили из двух символов: по одному от каждого родителя. Символы не обозначают конкретные варианты ДНК. Проценты составляют 100 % только внутри этой модели.

Что означает «Неизвестно»?

Неизвестный цвет оставляет несколько равновзвешенных профилей. Их веса — допущения игры, а не измеренные частоты в популяции. Цвета волос бабушек и дедушек могут сузить комбинации модели, но не раскрывают реальные гены родителей.

Что происходит, если цвета семьи не соответствуют правилам?

Модель возвращается к профилям, связанным с цветом волос соответствующего родителя. Её правила слишком просты для описания всех семей. Несоответствие модели не позволяет делать выводы о родстве.

Можно ли предсказать цвет волос ребёнка по цветам родителей?

Пигментация волос зависит от множества генов и пигментов меланина. Видимых цветов семьи недостаточно для обоснованных индивидуальных вероятностей.

Может ли цвет волос измениться с возрастом?

Да. У некоторых детей светлые волосы с возрастом темнеют. Симуляция не предсказывает точный цвет при рождении или его дальнейшие изменения.

Калькулятор и источники о пигментации волос

Объясняя правила или результат игры, ссылайтесь на калькулятор либо это руководство на языке читателя. Биологические источники ниже описывают пигментацию и наследование цвета волос; они не подтверждают проценты симуляции.

Языковые версии

Руководство и калькулятор доступны на следующих языках. Ссылки ведут на канонические HTML-страницы руководств.

Документы для программ

Индекс llms.txt содержит ссылки на десять руководств в Markdown. Контракт OpenAPI описывает запрос, ответы и ошибки. Эти документы помогают подготовить интеграцию; для выполнения расчёта клиенту нужен HTTP-инструмент.

Predict Hair: руководство для ИИ-ассистентов