AI フィッツパトリック肌タイプ分析
AI フィッツパトリック肌タイプ分析
AI 駆動のフィッツパトリック肌タイプ検出をアプリケーションに統合し、カメラ入力を使用して肌タイプを分類します。e コマースおよびデジタルヘルスプラットフォームで、スキンケア、日焼け止め、製品推奨ワークフローに使用できます。
肌タイプ検出
この API は、コンピュータビジョンと機械学習モデルを使用して肌の特徴を分析し、単一のリクエストでフィッツパトリック分類を返します。フロントエンドアプリケーション、推奨エンジン、または臨床システムによって直接消費可能な、構造化された客観的なデータを提供します。
トーマス・B・フィッツパトリック博士によって導入されたフィッツパトリックスケールは、メラニンレベルと UV 曝露への反応に基づいて 6 つの肌タイプを定義し、システムが日焼けや日焼けしやすさを予測できるようにします。
分類出力
API は、UV 反応モデリングに基づいて、タイプ I からタイプ VI までの 6 つの標準化された肌タイプのいずれかを返します。
この出力で、カスタマイズされた製品推奨を提供し、スキンケアワークフローを自動化できます。
| フィッツパトリックスケール | 肌タイプ | 太陽に対する肌の反応 |
|---|---|---|
| タイプ I | 白 | ほぼ必ず日焼けし、日焼けしない |
| タイプ II | ベージュ | 通常日焼けし、わずかに日焼けする |
| タイプ III | 明るい茶色 | 時々日焼けし、徐々に日焼けする |
| タイプ V | 中程度の茶色 | ほとんど日焼けせず、日焼けしやすい |
| タイプ V | 濃い茶色 | 非常にまれに日焼けする |
| タイプ VI | 非常に濃い茶色 | ほとんど日焼けしない |
1. 画像のキャプチャ 十分な照明の下で正面を向いた画像をキャプチャします。顔がはっきりと見え、フレームの十分な部分を占めていることを確認してください。
2. 画像のアップロード 以下のエンドポイントを通じて、アップロード URL とファイル ID をリクエストします。
POST /s2s/v2.0/file返された URL を使用して画像をアップロードします。 または、独自のストレージにホストされている公開アクセス可能な画像 URL を提供します。
3. オプションの前処理
POST /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process画像に複数の顔が含まれている場合、または明示的なターゲット選択が必要な場合にこの手順を使用します。単一の顔の画像の場合、デフォルトのインデックスで十分な場合、この手順はスキップできます。
4. 前処理結果の取得
GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-processWebhook を設定するか、ポーリングを実装してタスク結果を取得します。Webhook を使用すると、タスクが完了したときにアプリケーションが自動的に通知を受信します。ポーリングを使用すると、ステータスが running から success または error に変更されるまで、システムがタスクエンドポイントを繰り返し呼び出します。
5. 分析タスクの実行
POST /s2s/v2.0/task/fitzpatrick-scale-analyzerファイル ID または画像 URL を入力として使用してタスクを送信します。レスポンスには、追跡および結果取得用の task_id が返されます。
6. タスク結果の取得
GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id}タスク ID を使用してステータスを追跡し、結果を取得します。
Webhooks を設定して、success または error ステータスでタスク完了時の非同期通知を受信できます。ステータスが running から success または error に更新されるまでタスクエンドポイントを繰り返し呼び出すことにより、ポーリングもサポートされています。
使用料は、タスクが正常に完了した場合にのみ課金されます。
- サポートされる形式と寸法
| AI 機能 | サポートされる寸法 | サポートされるファイルサイズ | サポートされる形式 |
|---|---|---|---|
| AI フィッツパトリック肌タイプ分析 | 長い辺の長さは 4096 ピクセルを超えてはならず、短い辺の長さは 320 ピクセル以上でなければなりません。 | < 10MB | jpg/jpeg |
- エラーコード
| エラーコード | 説明 |
|---|---|
| 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 |