Skin Color：AIアシスタント向けガイド

Skin Colorは、6つの色見本と家族について選んだ色を使う視覚的なシミュレーションです。このガイドでは既存の計算方法、皮膚の色素に関する参考資料、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を持つ6件の結果が返り、視覚モデル内の合計は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": "ja"
}

この例を計算した応答

{
  "apiVersion": "1",
  "modelVersion": "skin-palette-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "ja",
  "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/ja",
  "documentationUrl": "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"
}

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

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

familyのフィールド
`mother`	母親
`father`	父親
`maternalGrandmother`	母方の祖母
`maternalGrandfather`	母方の祖父
`paternalGrandmother`	父方の祖母
`paternalGrandfather`	父方の祖父

使用できる色のコード
`VERYFAIR`	とても明るい
`FAIR`	明るい
`MEDIUM`	中間
`OLIVE`	オリーブ
`BROWN`	濃い
`BLACK`	とても濃い
`UNDEFINED`	不明

この肌の色シミュレーションはどのような仕組みですか？

六つの色見本に0から5の位置を割り当てています。入力された家族の位置の平均を求め、その平均を中心とする釣り鐘型の曲線に沿って結果を配分します。曲線の幅はコードで固定されており、遺伝子の測定に基づくものではありません。合計100%となる割合は、この視覚的なモデル内に限ったものです。

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

「不明」を選んだ人は平均の計算から外れます。中間の肌の色を割り当てるわけではありません。全員が不明なら、計算も結果表示も行いません。

祖父母の情報を追加すると何が変わりますか？

入力された人は、親も祖父母も同じ重みで平均に含まれます。そのため祖父母を追加すると平均が変わることがあります。これはモデルの設計上のルールであり、遺伝子を推定したり、祖父母が赤ちゃんの肌の色に与える影響を測ったりするものではありません。

家族の肌の色から信頼できる遺伝的な割合が分かりますか？

皮膚の色素には多くの遺伝子が関わります。六つの色見本を見た目で選ぶだけでは、それらの変異は特定できません。このシミュレーションは、赤ちゃん個人の肌の色の確率を推定するための検証を受けていません。

この色見本は科学的な肌の色の尺度ですか？

イラストの目安であり、標準化された色素の測定や出自の分類ではありません。最も近い色を選ぶか、「不明」のままにしてください。照明や画面によって色の見え方は変わり、赤ちゃんのイラストも出生時の正確な色を示すものではありません。

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

方法やシミュレーションの分布を説明する場合は、読者の言語の計算ツールまたはこのガイドを引用してください。以下の資料は多遺伝子形質と皮膚の色素を説明するもので、モデルの色見本の位置、家族の重み、割合を検証したものではありません。

言語別のページ

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

プログラム向けの文書

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