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の呼び出しに、特定のエージェント名やブラウザーを名乗る設定は必要ありません。

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

少なくとも一つの色が分かっている場合、color、label、percentageを持つ5件の結果が返り、ゲーム内の合計は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": "ja"
}
この例を計算した応答
{
  "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％になるのは、このモデルの中だけです。

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

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

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

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

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

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

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

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

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

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

言語別のページ

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

プログラム向けの文書

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

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