Standard Analysis

操作

エンドポイント概要

どんな機能か。 標準の AI 肌分析は、選択した肌悩みについて客観的・定量的なスコアを、精密な検出マスクとヒートマップとともに提供します。

最先端の AI ディープラーニングと顔領域セグメンテーションを搭載した Perfect Corp の AI 肌分析は、非接触でデジタル画像から目に見える肌状態を評価します。定量的なスコア、検出マスク、ヒートマップ、AR オーバーレイを提供する本ソリューションが、パーソナライズされたスキンケアのインサイトを通じて、ユーザーが自分の肌をより深く理解し、スキンケアの手順を最適化するのをサポートします。

対応している肌悩み:
- シワ
- うるおい
- ハリ
- 上まぶたの下垂
- 下まぶたの下垂
- 毛穴
- キメ
- ニキビ
- 皮脂
- シミ
- 目の下のクマ
- ツヤ
- 赤み
- 目元のたるみ
- 涙溝

そのほかの出力として、肌タイプ、推定肌年齢、総合肌状態スコアがあります。すべての結果は画像に基づく指標であり、スキンケアのインサイトとしてのご利用を想定したもので、臨床的な測定、診断、医学的な評価を構成するものではありません。

AI タスクを作成する

# Standard Skin Analysis V2.1
curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "src_file_url": "https://your-cdn.example.com/customer-001.jpg",
    "dst_actions": ["hd_wrinkle", "hd_pore", "hd_texture", "hd_acne"],
    "format": "zip",
    "pf_camera_kit": true
  }'

レポートとレコメンドをポーリングする

実行のたびに BasicRunTaskResponseV2 がただちに返されます。返された id でタスクをポーリングしてください。レポートとレコメンドは llm_results.json に届けられます。

# 1. Run the task and capture the task id
TASK_ID=$(curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }' | jq -r '.data.task_id')

# 2. Poll until task_status is "success"
curl -sS -H "Authorization: Bearer $API_KEY" \
  "$BASE_URL/s2s/v2.1/task/skin-analysis/$TASK_ID"

task_status は running → success | error と遷移します。format: zip の場合、results.url は 2 時間有効なダウンロードリンクで、ZIP には score_info.json とすべての検出画像を収めた skinanalysisResult フォルダが入っています。format: json の場合、results.output にスコアがレスポンス本文へ直接返されます。

リクエストフィールド早見表

フィールド	必須	説明
`src_file_id` / `src_file_url`	はい（いずれか 1 つ）	入力画像。`BasicRunTaskV2` に準拠
`dst_actions`	はい	HD 機能または SD 機能 — 混在は不可
`format`	いいえ	`zip`（デフォルト）\| `json` — レスポンススキーマが異なります
`pf_camera_kit`	いいえ	V2.1 で追加。顔の輪郭と各顔部位の位置特定
`miniserver_args`	いいえ	マスクオーバーレイと HD 毛穴・しわの背景の制御
`advanced_report`	いいえ	指定 → レポートを出力。`{}` → すべてデフォルト値。省略 → なし
`product_recommendation`	いいえ	指定 → レコメンドを出力。`catalog_id` が必要

解像度。 すべての出力画像は長辺 2560 px までに上限設定され、入力は自動的にリサイズされます。enable_mask_overlay が false の場合、生のマスクが .png で返されるため、合成はお客様側で行う必要があります — 入力解像度を確認し、長辺が 2560 px を超える場合は表示サイズを 2560 px 基準で設計してください。