髪の長さ分析

概要

AI 髪の長さ測定では、髪の長さを分析・測定し、パーソナライズされた製品やサービスの決定を支援します。耳上から背中中央までの 5 つの髪の長さを識別・分類します。

髪の長さ分析のための撮影方法
正面を向いて自撮り写真を撮影します
- カメラをまっすぐ見ている、1 枚のクリアな写真のみで十分です。髪を下ろして胸にかかっている状態にし、真正面を向いて撮影してください。
- 代わりに、JS Camera Kit を使用して写真を撮影します。髪を下ろして胸にかかっている状態にしてください。結ばないでください。
AI による髪の長さの検出方法
/s2s/v2.0/file API を使用して、以下のアセットをアップロードします:
- 自撮り写真。
AI タスク /s2s/v2.0/task/hair-length-detection の実行
正面を向いた自撮り画像を 1 枚送信して、髪の長さ検出タスクを実行します。AI のソース入力としてそのファイル ID を使用します。
タスクのステータスを成功またはエラーになるまでポーリングで確認します
この task_id は、GET 'task/hair-length-detection' によるポーリングを通じてタスクのステータスを監視するために使用され、現在のエンジンステータスを取得します。エンジンがタスクを完了するまで、ステータスは 'running' のままであり、この段階ではユニットは消費されません。

結果引数
term: 結果は、検出された髪の長さタイプを示す文字列です。考えられるすべての結果文字列を配列で以下に示します:
```
["above the ears", "ear length", "ear length or longer", "short hair", "short hair or longer", "above chest", "above chest or longer", "long hair"]
```
撮影方法の提案

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

エラーコード	説明
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
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 機能	消費ユニット
髪の長さ分析 V1.0	2

OpenAPI記述をダウンロード

概要

メール

ライセンス

言語

サーバー

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