# Skin Color：AI 助手使用指南

HTML: <https://www.skin-color.com/zh/%E9%9D%A2%E5%90%91ai%E5%8A%A9%E6%89%8B>

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：应先询问一种色调，再显示分布。

### 使用虚构选项的请求示例

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

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

### 该示例的实际计算响应

```json
{
  "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%，仅适用于这个视觉模型。

## “未知”是什么意思？

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

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

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

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

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

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

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

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

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

- [宝宝肤色计算器](<https://www.skin-color.com/zh>)
- [这个肤色模拟如何运作？](<https://www.skin-color.com/zh#yinger-pifu-yanse-jisuanqi-gongzuo-yuanli>)
- [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/>)

## 语言版本

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

- [العربية](<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>)

## 供程序读取的文档

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

- [Markdown 指南](<https://www.skin-color.com/llms/zh.md>)
- [OpenAPI 文档](<https://www.skin-color.com/openapi.json>)
- [llms.txt 索引](<https://www.skin-color.com/llms.txt>)
- [HTML 页面站点地图](<https://www.skin-color.com/sitemap.xml>)
- [隐私政策](<https://www.skin-color.com/zh/%E9%9A%90%E7%A7%81%E6%94%BF%E7%AD%96>)