AI 肌分析 V2.1 タスクを実行します。

リクエスト

AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、success または error の通知が来たら、受け取った task_id を使ってタスクの結果を照会します。設定と検証の詳細は Webhook 統合ガイドを参照してください。

Webhook がサポートされていない場合、または統合に使えない場合は、ポーリングを実装します。AI タスクを送信した後、一定の間隔（例：10 秒ごと）でステータスエンドポイントをポーリングし、success または error になるまで待ちます。

セキュリティ

BearerAuthenticationV2

ボディapplication/json必須

Any of:

このオブジェクトは、AI 肌分析タスクの実行を表します。

dst_actionsArray of strings(RunSkincareTaskDstActions)必須

AI 肌分析のアクションです。機能には HD と SD の 2 種類があります。 1 つ以上の機能を選択できますが、すべて SD またはすべて HD で選択する必要があります。注意: HD 機能と SD 機能を混在させることはできません。 HD 機能:

hd_redness: 肌の赤みの重症度を測定します。
hd_oiliness: 肌の油分レベルを判定します。
hd_age_spot: 老人斑と色素沈着を検出します。
hd_radiance: 肌の輝度を評価します。
hd_moisture: 肌の水分量を評価します。
hd_dark_circle: 目の下のクマの有無を分析します。
hd_eye_bag: 目の下のたるみ（目袋）を検出します。
hd_droopy_upper_eyelid: 上まぶたのたるみの重症度を測定します。
hd_droopy_lower_eyelid: 下まぶたのたるみの重症度を測定します。
hd_firmness: 肌の弾力性とハリを評価します。
hd_texture: 肌全体の質感を分析します。
hd_acne: ニキビの有無を検出します。
hd_pore: 異なる顔領域（額、鼻、頬、全体）の毛穴を検出し評価します。
hd_wrinkle: 様々な顔領域（額、眉間、目尻、目周り、ほうれい線、マリオネットライン、全体）のしわの重症度を測定します。
hd_tear_trough: 涙袋（ゴルゴライン）を検出します。
hd_skin_type: サブカテゴリー（全体、T ゾーン、U ゾーン）で肌タイプを Normal、Oily、Dry、Combination、Redness、Dry and Redness、Oily and Redness、Combination and Redness のいずれかで評価します。

SD 機能:

wrinkle: 一般的なシワ分析。
droopy_upper_eyelid: 上まぶたのたるみの重症度を測定します。
droopy_lower_eyelid: 下まぶたのたるみの重症度を測定します。
firmness: 肌の弾力性とハリを評価します。
acne: ニキビの有無を評価します。
moisture: 肌の水分量を測定します。
eye_bag: 目の下のたるみ（目袋）を検出します。
dark_circle_v2: クマを分析します。
age_spot: 老人斑を検出します。
radiance: 肌の明るさを評価します。
redness: 肌の赤みを測定します。
oiliness: 肌の油分を判定します。
pore: 毛穴の目立ち度を測定します。
texture: 肌全体の質感を分析します。
tear_trough: 涙袋（ゴルゴライン）を検出します。
skin_type: サブカテゴリー（全体、T ゾーン、U ゾーン）で肌タイプを Normal、Oily、Dry、Combination、Redness、Dry and Redness、Oily and Redness、Combination and Redness のいずれかで評価します。

Items Enum:"hd_wrinkle""hd_pore""hd_texture""hd_acne""hd_oiliness""hd_radiance""hd_eye_bag""hd_age_spot""hd_dark_circle""hd_droopy_upper_eyelid"

例:

[
  "hd_wrinkle",
  "hd_pore",
  "hd_texture",
  "hd_acne"
]

miniserver_argsobject(RunSkincareTaskMiniserverArgs)

formatstring

分析結果のレスポンス形式。初期値は 'zip' です。 - zip: 結果は、score_info.json とすべての検出結果画像を含む skinanalysisResult フォルダを格納したダウンロード可能な ZIP ファイルとしてパッケージ化されます。レスポンスには ZIP ファイルをダウンロードするための URL が含まれます。 - json: 結果は JSON 形式でレスポンスボディに直接返されます。注意: format=json と format=zip でレスポンススキーマが異なります。

Enum:"json""zip"

例:"zip"

pf_camera_kitboolean

例:true

src_file_urlstring必須

タスクを実行するファイルの URL。この URL は公開されている必要があります。

例:"https://example.com/selfie.jpg"

curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.1/task/skin-analysis \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_url": "https://example.com/selfie.jpg",
    "dst_actions": [
      "hd_wrinkle",
      "hd_pore",
      "hd_texture",
      "hd_acne"
    ],
    "miniserver_args": {
      "enable_mask_overlay": true,
      "enable_dark_background_hd_pore": true,
      "color_dark_background_hd_pore": "3D3D3D",
      "opacity_dark_background_hd_pore": 0.4,
      "enable_dark_background_hd_wrinkle": true,
      "color_dark_background_hd_wrinkle": "3D3D3D",
      "opacity_dark_background_hd_wrinkle": 0.4
    },
    "format": "zip",
    "pf_camera_kit": true
  }'

レスポンス

AI 肌分析タスクの実行に成功しました

ボディapplication/json

statusinteger

レスポンスステータス

例:200

dataobject

レスポンス

{
  "status": 200,
  "data": {
    "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
  }
}