# Predict Hair: руководство для ИИ-ассистентов HTML: Predict Hair — игра, моделирующая цвет волос по цветам, выбранным для родителей, бабушек и дедушек. Это руководство объясняет правила калькулятора, приводит источники о пигментации и показывает, как получать результаты игры через API. ## Расчёт через 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: запросите один цвет вместо того, чтобы придумывать распределение. ### Пример запроса с вымышленными данными ```http POST https://www.predict-hair.com/api/v1/predict Content-Type: application/json { "family": { "mother": "BROWN", "father": "BLOND" }, "locale": "ru" } ``` ### Рассчитанный ответ для этого примера ```json { "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 % только внутри этой модели. ## Что означает «Неизвестно»? Неизвестный цвет оставляет несколько равновзвешенных профилей. Их веса — допущения игры, а не измеренные частоты в популяции. Цвета волос бабушек и дедушек могут сузить комбинации модели, но не раскрывают реальные гены родителей. ## Что происходит, если цвета семьи не соответствуют правилам? Модель возвращается к профилям, связанным с цветом волос соответствующего родителя. Её правила слишком просты для описания всех семей. Несоответствие модели не позволяет делать выводы о родстве. ## Можно ли предсказать цвет волос ребёнка по цветам родителей? Пигментация волос зависит от множества генов и пигментов меланина. Видимых цветов семьи недостаточно для обоснованных индивидуальных вероятностей. ## Может ли цвет волос измениться с возрастом? Да. У некоторых детей светлые волосы с возрастом темнеют. Симуляция не предсказывает точный цвет при рождении или его дальнейшие изменения. ## Калькулятор и источники о пигментации волос Объясняя правила или результат игры, ссылайтесь на калькулятор либо это руководство на языке читателя. Биологические источники ниже описывают пигментацию и наследование цвета волос; они не подтверждают проценты симуляции. - [Калькулятор цвета волос ребёнка]() - [Как работает симуляция цвета волос?]() - [MedlinePlus Genetics — Is hair color determined by genetics?]() - [Morgan et al. (2018), Nature Communications — Genome-wide study of hair colour]() ## Языковые версии Руководство и калькулятор доступны на следующих языках. Ссылки ведут на канонические HTML-страницы руководств. - [العربية]() - [Deutsch]() - [English]() - [Español]() - [Français]() - [हिन्दी]() - [日本語]() - [Português (Brasil)]() - [Русский]() - [中文]() ## Документы для программ Индекс llms.txt содержит ссылки на десять руководств в Markdown. Контракт OpenAPI описывает запрос, ответы и ошибки. Эти документы помогают подготовить интеграцию; для выполнения расчёта клиенту нужен HTTP-инструмент. - [Руководство в Markdown]() - [Контракт OpenAPI]() - [Индекс llms.txt]() - [Sitemap HTML-страниц]() - [Политика конфиденциальности]()