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

Расчёт через 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.skin-color.com/api/v1/predict
Content-Type: application/json

{
  "family": {
    "mother": "FAIR",
    "father": "BROWN"
  },
  "locale": "ru"
}

{
  "apiVersion": "1",
  "modelVersion": "skin-palette-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "ru",
  "status": "ok",
  "unit": "percent",
  "results": [
    {
      "color": "VERYFAIR",
      "label": "Очень светлая",
      "percentage": 1.76
    },
    {
      "color": "FAIR",
      "label": "Светлая",
      "percentage": 12.97
    },
    {
      "color": "MEDIUM",
      "label": "Средняя",
      "percentage": 35.27
    },
    {
      "color": "OLIVE",
      "label": "Оливковая",
      "percentage": 35.27
    },
    {
      "color": "BROWN",
      "label": "Тёмная",
      "percentage": 12.97
    },
    {
      "color": "BLACK",
      "label": "Очень тёмная",
      "percentage": 1.76
    }
  ],
  "explanation": "Развлекательная модель: проценты — это веса произвольно заданной математической кривой, а не измеренные генетические вероятности для вашего ребёнка.",
  "sourceUrl": "https://www.skin-color.com/ru",
  "documentationUrl": "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"
}

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

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

Как работает эта модель оттенка кожи?

Шести образцам цвета присвоены позиции от 0 до 5. Инструмент вычисляет среднее позиций указанных членов семьи и распределяет результаты по колоколообразной кривой вокруг этого среднего. Её ширина задана в коде и не основана на генетических измерениях. Сумма процентов равна 100% только внутри этой визуальной модели.

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

Вариант «Неизвестно» исключает человека из расчёта среднего, а не присваивает ему средний оттенок кожи. Если все оттенки неизвестны, расчёта и результата нет.

Что меняют бабушки и дедушки в модели?

Каждый указанный человек имеет одинаковый вес: и родитель, и бабушка или дедушка. Добавление родственника может сдвинуть среднее. Это правило построения модели; оно не восстанавливает гены и не измеряет влияние бабушки или дедушки на оттенок кожи ребёнка.

Можно ли получить достоверные генетические проценты по оттенкам кожи семьи?

На пигментацию кожи влияют многие гены. Визуальный выбор из шести образцов не определяет эти варианты. Эта модель не прошла проверку для оценки индивидуальных вероятностей оттенка кожи ребёнка.

Образцы составляют научную шкалу цвета кожи?

Это ориентиры для иллюстраций, а не стандартизированное измерение пигментации или категории происхождения. Выберите ближайший оттенок или оставьте «Неизвестно». Освещение и экраны меняют восприятие цвета; изображения младенцев не показывают точный цвет кожи при рождении.

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

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

• Калькулятор цвета кожи ребёнка
• Как работает эта модель оттенка кожи?
• NHGRI — Polygenic Trait
• Crawford et al. (2017), Science — Loci associated with skin pigmentation identified in African populations

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

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

• العربية
• Deutsch
• English
• Español
• Français
• हिन्दी
• 日本語
• Português (Brasil)
• Русский
• 中文

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

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

• Руководство в Markdown
• Контракт OpenAPI
• Индекс llms.txt
• Sitemap HTML-страниц
• Политика конфиденциальности