フェイスリフト検出タスクを実行します。

リクエスト

ソース画像に複数の有効なターゲットが含まれる可能性がある場合、またはエフェクトを適用する検出ターゲットを明示的に選びたい場合は、前処理タスクを使います。単一ターゲットの画像では、機能がデフォルトの index 値をサポートしているため、手動でのターゲット選択が不要な場合は前処理をスキップできます。

前処理タスクは、ソース画像内の候補ターゲットを検出し、その座標を data.results.result に返します。結果配列の各項目は、検出された 1 つのターゲットを表します。返された座標を確認し、ソース画像内の意図した顔や領域に対応づけたうえで、エフェクトタスクを作成する際にその項目のゼロベース配列インデックスを index 値として使います。

複数の顔や領域が検出された画像では、前処理の結果を確認せずにデフォルトの index 値に頼らないでください。エフェクトは index で選択されたターゲットにしか適用されないため、エフェクトタスクを実行する前に、意図したターゲットに対応する結果項目を確認する必要があります。

このタスクは非同期です。タスクを作成した後、機能がサポートしている場合は Webhook で完了を処理するか、対応する前処理ステータスエンドポイントをポーリングして data.task_status が success または error になるまで待ちます。

セキュリティ

BearerAuthenticationV2

ボディapplication/json必須

Any of:

src_file_urlstring必須

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

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

curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/face-lift/pre-process \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_url": "https://example.com/selfie.jpg"
  }'

レスポンス

タスクの実行に成功しました

ボディapplication/json

statusinteger

レスポンスステータス

例:200

dataobject

レスポンス

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