# Predict Hair：AIアシスタント向けガイド

HTML: <https://www.predict-hair.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>

Predict Hairは、両親と祖父母について選んだ色を使う髪色シミュレーションゲームです。このガイドでは計算ツールのルール、髪の色素に関する参考資料、APIでゲームの結果を取得する方法を説明します。

## APIで計算する

HTTPクライアントを持つアシスタントはPOST /api/v1/predictを呼び出せます。Content-Type: application/jsonを指定し、最大1024バイトのUTF-8 JSONを送信してください。公開APIのためキーやCookieは不要です。色はリクエスト本文に含めます。URLのクエリーパラメーターは受け付けません。

HTTPクライアントは元のUser-Agentをそのまま使えます。資料の閲覧や計算APIの呼び出しに、特定のエージェント名やブラウザーを名乗る設定は必要ありません。

サイトの計算ツールは引き続きブラウザー内で動作します。APIは色のコードと言語を受け取り、メモリー内で処理します。選択内容や結果をアプリケーションに保存せず、応答に家族の入力情報をそのまま返すこともありません。応答はキャッシュしません。ホスティングでは接続に必要な技術データを処理します。

少なくとも一つの色が分かっている場合、color、label、percentageを持つ5件の結果が返り、ゲーム内の合計は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": "ja"
}
```

### この例を計算した応答

```json
{
  "apiVersion": "1",
  "modelVersion": "hair-game-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "ja",
  "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/ja",
  "documentationUrl": "https://www.predict-hair.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"
}
```

## 入力フィールドと色のコード

familyオブジェクトは必須ですが、その六つのフィールドはすべて任意です。省略した色はUNDEFINEDになります。localeも任意で、既定値はenです。言語にかかわらず、以下のフィールド名と大文字のコードをそのまま使います。余分なフィールドや未定義の値は拒否します。

### familyのフィールド

- `mother`: 母
- `father`: 父
- `maternalGrandmother`: 母方祖母
- `maternalGrandfather`: 母方祖父
- `paternalGrandmother`: 父方祖母
- `paternalGrandfather`: 父方祖父

### 使用できる色のコード

- `BLACK`: 黒
- `BROWN`: 茶色
- `RED`: 赤
- `BLOND`: ブロンド
- `STBLOND`: とても明るいブロンド
- `UNDEFINED`: 不明

## 計算ツールが使うルール

ゲームでは黒、茶、赤、金、明るい金の五分類を固定の順序で扱います。二つの記号からなる架空の型を組み合わせ、両親から一つずつ記号を受け取ります。記号は特定のDNA変異を表しません。割合が100％になるのは、このモデルの中だけです。

## 「不明」とはどういう意味ですか？

不明の髪色には複数の型を同じ重みで残します。重みはゲーム上の仮定であり、集団で測定された頻度ではありません。祖父母の髪色でモデル内の組み合わせが絞られても、両親の実際の遺伝子が分かるわけではありません。

## 家族の髪色がルールに合わない場合は？

その親の髪色に対応する型に戻して計算します。モデルは単純すぎるため、すべての家族を表せません。モデルと合わなくても、血縁関係について判断することはできません。

## 両親の髪色だけで赤ちゃんの髪色を予測できますか？

髪の色素には多数の遺伝子とメラニン色素が関わります。家族の見た目の髪色だけでは、個人について検証された確率を示せません。

## 髪色は年齢とともに変わりますか？

はい。明るい髪の子どもが成長につれて暗い髪色になることがあります。このシミュレーションは出生時の正確な色も、その後の変化も予測しません。

## 計算ツールと髪の色素に関する資料

ゲームのルールや結果を説明する場合は、読者の言語の計算ツールまたはこのガイドを引用してください。以下の生物学資料は髪の色素と遺伝を説明するもので、シミュレーションの割合を検証したものではありません。

- [赤ちゃんの髪色シミュレーター](<https://www.predict-hair.com/ja>)
- [この髪色シミュレーションの仕組みは？](<https://www.predict-hair.com/ja#%E8%B5%A4%E3%81%A1%E3%82%83%E3%82%93%E3%81%AE%E9%AB%AA%E8%89%B2%E8%A8%88%E7%AE%97%E6%A9%9F%E3%81%AE%E4%BB%95%E7%B5%84%E3%81%BF>)
- [MedlinePlus Genetics — Is hair color determined by genetics?](<https://medlineplus.gov/genetics/understanding/traits/haircolor/>)
- [Morgan et al. (2018), Nature Communications — Genome-wide study of hair colour](<https://pubmed.ncbi.nlm.nih.gov/30531825/>)

## 言語別のページ

ガイドと計算ツールは以下の言語で利用できます。リンク先は各ガイドの正規HTMLページです。

- [العربية](<https://www.predict-hair.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.predict-hair.com/de/fuer-ki-assistenten>)
- [English](<https://www.predict-hair.com/for-ai-assistants>)
- [Español](<https://www.predict-hair.com/es/para-asistentes-ia>)
- [Français](<https://www.predict-hair.com/fr/pour-les-assistants-ia>)
- [हिन्दी](<https://www.predict-hair.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.predict-hair.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.predict-hair.com/pt/para-assistentes-ia>)
- [Русский](<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>)
- [中文](<https://www.predict-hair.com/zh/%E9%9D%A2%E5%90%91ai%E5%8A%A9%E6%89%8B>)

## プログラム向けの文書

llms.txtには10言語のMarkdownガイドへのリンクがあります。OpenAPI仕様にはリクエスト、レスポンス、エラーを定義しています。これらは連携の準備に使えますが、計算を実行するクライアントにはHTTPツールが必要です。

- [Markdown版ガイド](<https://www.predict-hair.com/llms/ja.md>)
- [OpenAPI仕様書](<https://www.predict-hair.com/openapi.json>)
- [llms.txt索引](<https://www.predict-hair.com/llms.txt>)
- [HTMLサイトマップ](<https://www.predict-hair.com/sitemap.xml>)
- [プライバシーポリシー](<https://www.predict-hair.com/ja/%E3%83%97%E3%83%A9%E3%82%A4%E3%83%90%E3%82%B7%E3%83%BC%E3%83%9D%E3%83%AA%E3%82%B7%E3%83%BC>)