コンテンツへスキップ

髪タイプ分析

概要

AI 髪タイプ分析では、髪の質感、厚み、カールのパターンを分析し、ストレートから kinky までの 9 つの明確なタイプに分類します。

統合ガイド

  • AI 髪タイプ分析のための撮影方法

  • 左、正面、右の 3 方向から写真を撮影します。

    • 3 枚のセルフポートレートを素早く撮影してください。1 枚は正面を向き、1 枚は左に約 45 度回転し、1 枚は右に 45 度回転します。髪の全体像をあらゆる角度から捉えることが目的です。各写真で顔全体と髪の上部の境界線がはっきりと見えるようにしてください。顔が画像幅の約 50% から 80% を占めるようにします。小さすぎず、近すぎない距離で撮影してください。これにより、分析に十分な鮮明さが確保されます。横顔のショットを撮影する際は、首を左右に振る（ヨー回転）ように頭を回転させてください。頭を上下左右に傾けず、水平に保ってください。背面や上からの角度は分析に使用できないため、避けてください。
    • 写真撮影には JS Camera Kit を利用できます。髪を結ばず、胸の前で垂らした状態にしてください。頭を右に向けて静止し、次に左に向けて、分析用の 3 枚の画像を撮影します。

  • AI による髪タイプの検出方法

  • /s2s/v2.0/file API を使用して、以下のアセットをアップロードしてください：

    • 正面、右側面、左側面の写真。

  • AI タスク /s2s/v2.0/task/hair-type-detection の実行
    正面、右側面、左側面の 3 枚の画像を送信して、髪タイプ検出タスクを実行します。これらのファイル ID を AI のソース入力として使用します。

  • タスクのステータスを成功またはエラーになるまでポーリングで確認する
    この task_id は、GET 'task/hair-type-detection' によるポーリングを通じてタスクのステータスを監視するために使用され、現在のエンジンステータスを取得します。エンジンがタスクを完了するまで、ステータスは 'running' のままとなり、この段階ではユニットは消費されません。

髪タイプの分類

カテゴリーサムネイル髪タイプの分類説明
1ストレートカールがなく、根元から毛先までストレートに落ちる髪
2Aややウェーブ控えめで繊細なウェーブ。滑らかな質感、根元にボリュームはありません
2B中程度のウェーブ髪の中間部から始まる S 字型のウェーブ
2C厚手のウェーブ根元から始まる S 字型のウェーブ。粗い質感、広がりやすい
3Aゆるいカール大きくゆるやかなカール
3B中程度のカーリー粗く弾力のあるリングレット。広がりやすい
3Cタイトなカーリー密でコンパクトなコルクスクリュー形状
4Akinky ソフト密に詰まった弾力のある S 字型のコイル
4Bコイリー鋭いジグザグ角度に強く巻き込まれた、密に詰まったコイル
4C極度のコイリーきつくふわふわしたコイル。切れやすい

  • 結果引数

  • mapping: 結果は、検出された髪タイプのカテゴリーを示す文字列です。考えられるすべての結果文字列を配列で以下に示します：

    ["1 to 2a", "2a to 2b", "2b to 2c", "2c to 3a", "3a to 3b", "3b to 3c", "3c to 4a", "4a to 4b", "4b to 4c"]

  • term: 髪タイプのカテゴリーとその分類間の 1 対 1 のマッピング文字列です。考えられるすべての結果文字列を配列で以下に示します：

    ["Straight to Slight Wavy", "Slight to Medium Wavy", "Medium to Thick Wavy", "Thick Wavy to Loose Curls", "Loose to Medium Curls", "Medium to Tight Curls", "Tight Curls to Kinky Soft", "Kinky Soft to Coily", "Coily to Extremely Coily"]

  • 撮影方法のヒント 撮影方法のヒント

ファイル仕様とエラー

  • 対応フォーマットと寸法
タイプ対応寸法対応ファイルサイズ対応フォーマット
AI 髪タイプ分析画像は幅と高さともに少なくとも 320 ピクセル、いずれかの次元で最大 4096 ピクセルである必要があります。画像の片側の長さが 1080 ピクセルを超える場合、分析用にその制限内に自動的にリサイズされます。< 10MBjpg/png
  • エラーコード
エラーコード説明
error_mismatch_image_sizeすべての顔写真（正面、左、右）が同じサイズであることを確認してください
error_below_min_image_size画像の幅または高さが 320 ピクセル未満の場合、使用するには小さすぎます
error_face_position_invalid画像内で顔全体が完全に可視であり、一部が切れていない必要があります
error_face_position_too_small写真内の顔が小さすぎて、適切に分析できません
error_face_position_out_of_boundary顔が大きすぎるか、写真の端の一部が外れています
error_insufficient_lighting照明が暗すぎて、分析が困難です
error_face_angle_invalid顔の角度が適切ではありません。正面を向いたショットでは、頭を正面から 10 度以内に保ってください。横顔を向いたショットでは、角度が 15 度以上である必要があります
  • 環境と依存関係
サンプルコード言語 / ツール推奨ランタイムバージョン
cURL- bash >= 3.2
- curl >= 7.58 (モダンな TLS/HTTP サポート)
- jq >= 1.6 (堅牢な JSON 解析)
Node.js (JavaScript)Node >= 18 (グローバル fetch のため)
JavaScript- Chrome / Edge >= 80
- Firefox >= 74
- Safari >= 13.1
PHPPHP >= 7.4 (モダンな TLS/互換性のため), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json
PythonPython >= 3.10 (f-strings のため), requests >= 2.20.0
JavaJava 11+ (HttpClient のため), Jackson Databind >= 2.12.0

JS Camera Kit

ユニット消費

AI 機能消費ユニット
AI 髪タイプ分析 V1.02
OpenAPI記述をダウンロード
ai_hair_type_detection.json
ai_hair_type_detection.yaml
概要
メール
YouCamOnlineEditor_API@perfectcorp.com
ライセンス
Privacy policy
利用規約
言語
サーバー
https://yce-api-01.makeupar.com