髪密度分析

概要

AI 髪密度分析では、アップロードした 1 枚の画像から頭皮の可視性と髪の分布パターンを評価し、髪の密度を 4 つのレベルに分類します。

AI 髪密度分析用の写真の撮影方法
セルフィーを撮影する
- カメラを正面に向け、適切な照明の下で頭を45度下げてください。髪を結ばず、生え際全体がはっきりと見えるようにしてください。
- 代わりに、JS Camera Kit を使用して写真を撮影してください。
AI による髪密度の検出方法
/s2s/v2.0/file API を使用して、以下のアセットをアップロードします：
- セルフィー写真。
AI タスク /s2s/v2.0/task/hair-density-detection を実行
正面から45度下げたセルフィー画像を1枚送信して検出タスクを実行します。AI のソース入力としてそのファイル ID を使用します。
タスクのステータスを成功またはエラーになるまでポーリングして確認する
この task_id は、GET 'task/hair-density-detection' によるポーリングを通じてタスクのステータスを監視するために使用され、現在のエンジンステータスを取得します。エンジンがタスクを完了するまで、ステータスは 'running' のままであり、この段階ではユニットは消費されません。

サムネイル	髪密度の分類	説明
	レベル 1 極めて低い密度	髪が著しくまばらで、広い範囲で頭皮が見えます。
	レベル 2 低い密度	特に頭頂部や分け目で頭皮がはっきりと見える、目立つ薄毛があります。
	レベル 3 中程度の密度	直射日光の下で頭皮が部分的に見えますが、髪は中程度のボリュームとカバー率を維持しています。
	レベル 4 高い密度	髪はふさふさで厚く見え、頭皮はほとんどまたは全く見えません。

撮影方法のヒント

タイプ	対応寸法	対応ファイルサイズ	対応フォーマット
AI 髪密度分析	画像は幅と高さが少なくとも100ピクセル、いずれかの次元で4096ピクセル以下である必要があります。画像の片方の辺が1080ピクセルを超える場合、分析のためにその制限内に自動的にリサイズされます。	< 10MB	jpg/png

エラーコード	説明
error_below_min_image_size	画像の幅または高さが100ピクセル未満の場合、小さすぎて使用できません
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
PHP	PHP >= 7.4 (モダンな TLS/互換性のため)、ext-curl (推奨) または allow_url_fopen=On + ext-openssl、ext-json
Python	Python >= 3.10 (f-strings のため)、requests >= 2.20.0
Java	Java 11+ (HttpClient のため)、Jackson Databind >= 2.12.0

AI 機能	消費ユニット
AI 髪密度分析 V1.0	1

OpenAPI記述をダウンロード

概要

メール

ライセンス

言語

サーバー

https://yce-api-01.makeupar.com