Skin Color：AI 助手使用指南

Skin Color 使用六个色块和为家庭成员选择的色调进行视觉模拟。本指南介绍计算器现有的计算方法、皮肤色素的参考资料，以及通过 API 获取模拟分布的方法。

通过 API 计算

具有 HTTP 客户端的助手可以调用 POST /api/v1/predict。请使用 Content-Type: application/json，发送不超过 1024 字节的 UTF-8 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": "zh"
}

该示例的实际计算响应

{
  "apiVersion": "1",
  "modelVersion": "skin-palette-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "zh",
  "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/zh",
  "documentationUrl": "https://www.skin-color.com/zh/%E9%9D%A2%E5%90%91ai%E5%8A%A9%E6%89%8B"
}

输入字段与颜色代码

family 对象为必填，但其中六个字段均可省略，省略的颜色按 UNDEFINED 处理。locale 可选，默认值为 en。无论使用何种语言，都应保留下列字段名和大写代码。额外字段或未识别的值会被拒绝。

family 的字段
`mother`	母亲
`father`	父亲
`maternalGrandmother`	外祖母
`maternalGrandfather`	外祖父
`paternalGrandmother`	祖母
`paternalGrandfather`	祖父

接受的颜色代码
`VERYFAIR`	很浅
`FAIR`	浅
`MEDIUM`	中等
`OLIVE`	橄榄色
`BROWN`	深
`BLACK`	很深
`UNDEFINED`	未知

这个肤色模拟如何运作？

六个色块分别对应0到5的位置。工具计算已填写的家庭成员所对应位置的平均值，再以该平均值为中心，按钟形曲线分配结果。曲线的宽度在代码中固定，并非根据遗传数据测得。百分比之和为100%，仅适用于这个视觉模型。

“未知”是什么意思？

选择“未知”会将该成员排除在平均值计算之外，而不是为其指定中等肤色。如果全部未知，就不进行计算，也不显示结果。

祖父母和外祖父母的信息会改变什么？

每个已填写的家庭成员权重相同，无论是父母还是祖父母、外祖父母。添加一位长辈可能改变平均值。这是模拟的设计规则，并不能推断基因，也不能衡量某位长辈对宝宝肤色的遗传影响。

家人的肤色能给出可靠的遗传百分比吗？

皮肤色素受到许多基因的影响。从六个色块中凭外观选择，无法确定这些基因变异。本模拟尚未经过验证，不能据此估算某个宝宝的肤色概率。

这些色块是科学的肤色量表吗？

它们只是插图参考，不是标准化的色素测量，也不是血统类别。请选择最接近的色块，或保留“未知”。光线和屏幕可能改变颜色的观感，宝宝插图也不代表出生时的准确肤色。

计算器与皮肤色素参考资料

解释方法或模拟分布时，请引用读者所用语言的计算器页面或本指南。下列资料介绍多基因性状和皮肤色素，并不验证模型的色块位置、家庭成员权重或百分比。

语言版本

指南和计算器提供以下语言版本。链接指向各指南的规范 HTML 页面。

供程序读取的文档

llms.txt 索引列出了十种语言的 Markdown 指南。OpenAPI 规范描述请求、响应和错误。这些文档可用于准备集成；客户端需要具备 HTTP 工具才能执行计算。