Predict hair color logoPREDICT HAIR
头发颜色计算器

Predict Hair：AI 助手使用指南

Predict Hair 是一款根据父母和祖父母所选发色运行的模拟游戏。本指南介绍计算器的规则、毛发色素的参考资料，以及通过 API 获取游戏结果的方法。

Markdown 指南

通过 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.predict-hair.com/api/v1/predict
Content-Type: application/json

{
  "family": {
    "mother": "BROWN",
    "father": "BLOND"
  },
  "locale": "zh"
}
该示例的实际计算响应
{
  "apiVersion": "1",
  "modelVersion": "hair-game-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "zh",
  "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/zh",
  "documentationUrl": "https://www.predict-hair.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祖父
接受的颜色代码
BLACK黑色
BROWN棕色
RED红色
BLOND金色
STBLOND浅金色
UNDEFINED未知

计算工具采用的规则

游戏使用五个类别，按黑色、棕色、红色、金色、浅金色的固定顺序处理。它组合由两个符号构成的虚拟类型，父母各传递一个符号。这些符号不代表已确定的DNA变异。百分比仅在这个模型内合计为100%。

“未知”是什么意思？

未知发色会保留多个等权重的可能类型。权重是游戏假设，不是人群中测得的频率。祖父母的发色可缩小模型中的组合范围，但不能揭示父母的真实基因。

家庭发色不符合模型规则时怎么办？

模型会退回到与相应父母发色相关的类型。模型规则过于简单，无法描述所有家庭。不符合模型不能用来判断亲子关系。

仅凭父母发色就能预测宝宝发色吗？

头发色素受许多基因和黑色素影响。仅凭家人可见的发色，无法给出经过验证的个体概率。

发色会随年龄变化吗？

会。有些儿童的浅色头发会随成长变深。本模拟既不预测出生时的精确发色，也不预测其变化。

计算器与毛发色素参考资料

介绍游戏规则或结果时，请引用读者所用语言的计算器页面或本指南。下列生物学资料解释毛发色素和遗传，并不验证模拟中的百分比。

语言版本

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

供程序读取的文档

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

Predict Hair：AI 助手使用指南