顔パーツ補正

統合ガイド

このガイドでは、以下を説明します：

AI 顔パーツ補正 API のワークフロー：

エンドポイント: /s2s/v2.0/file

認証が必要: Authorization: Bearer YOUR_API_KEY

ワークフローの手順:

1. 画像アップロードの準備:

   • アップロード用のセルフィー画像を準備します。
   • File API /s2s/v2.0/file を呼び出し、アップロード URL と関連する file_id を取得します。
   • 提供されたアップロード URL を使用してセルフィー画像をアップロードします。

2. 複数顔の場合のオプションの前処理:

   • 画像内に複数の顔がある場合、セルフィー画像を前処理します。

3. 顔パーツ補正効果の設定:

   • まず、目、顔、唇、または鼻に適した顔パーツ補正パラメータを選択します。

4. AI タスクの開始とタスク ID の取得:

   • 選択した効果設定とともに file_id を HTTP POST リクエストで /s2s/v2.0/task/face-reshape に送信します。
   • このやり取りを識別する一意のタスク ID をレスポンスで待ちます。

5. タスクステータスのポーリング（継続的な確認）:

   • 取得した task_id を使用し、HTTP GET リクエスト（例：GET /s2s/v2.0/task/face-reshape/${task_id}）で定期的にタスクステータスをポーリングします。
   • 以下を継続的に監視します：
     • Task_status = "success"（処理完了）。
     • Task_status = "error"（該当する場合、解決または再試行）。
   • ステータスが success に遷移したら、ワークフローを適切に更新します。

• API プレイグラウンド

API プレイグラウンドで API を対話的にテストします：

API プレイグラウンド: http://yce.makeupar.com/api-console/en/api-playground/ai-face-reshape/

• 認証

• Bearer トークン を使用して、リクエストヘッダーに API キーを含めます：
  Authorization: Bearer YOUR_API_KEY

API キーの確認場所: https://yce.makeupar.com/api-console/en/api-keys/.

1. 画像のアップロード

   ファイルをサーバーに直接アップロードするか、AI タスクペイロードに有効な画像 URL を指定します。

   • アップロードエンドポイント

     POST /s2s/v2.0/file

     すでに公開画像 URL がある場合は、この手順をスキップできます。

2. 効果テンプレートの準備

   • 前処理 ピクセル座標で検出されたバウンディングボックスを出力します。結果のインデックスを使用して、後で顔パーツ補正 AI タスクを作成します。

     {
         "timed": number,
         "result": [
             {
                 "left": number,
                 "top": number,
                 "width": number,
                 "height": number
             }
         ]
     }

     • 効果テンプレート JSON スキーマ
     {
         "version": "1.0",
         "index": 0,
         "features": {},
         "global": {
         "skin_smooth_strength": 50,
         "skin_smooth_color_intensity": 50,
         },
     }

     index: 前処理で検出された顔のインデックス。省略可、初期値 0。 features: 少なくとも 1 つの非ゼロの顔パーツ補正パラメータが必要。すべてゼロにはできません。 skin_smooth_strength: 0~100 skin_smooth_color_intensity: 0~100

     • 効果フォーマット
     • 顔 初期範囲: -100~100 頬骨と顎の範囲: 0~100 すべての機能値が同時にゼロであってはなりません。少なくとも 1 つの機能値は非ゼロである必要があります
     {
         "cheekbones": 0,
         "jaw": 0,
         "face_reshape_left": 0,
         "face_reshape_right": 0,
         "face_width": 0,
         "chin_reshape_left": 0,
         "chin_reshape_right": 0,
         "chin_length": 0,
     }

     • 目 初期範囲: -100~100 すべての機能値が同時にゼロであってはなりません。少なくとも 1 つの機能値は非ゼロである必要があります
     {
         "eye_size_left": 0,
         "eye_size_right": 0,
         "eye_distance": 0,
         "eye_angle": 0,
         "eye_height": 0,
         "eye_width": 0,
     }

     • 鼻 初期範囲: -100~100 すべての機能値が同時にゼロであってはなりません。少なくとも 1 つの機能値は非ゼロである必要があります
     {
         "nose_bridge_width": 0,
         "nose_lift": 0,
         "nose_size": 0,
         "nose_tip": 0,
         "nose_tip_width": 0,
         "nose_wing": 0
     }

     • 唇 初期範囲: -100~100 すべての機能値が同時にゼロであってはなりません。少なくとも 1 つの機能値は非ゼロである必要があります
     {
         "lip_size": 0,
         "lip_width": 0,
         "lip_peak": 0,
         "lip_height_top": 0,
         "lip_height_bottom": 0,
     }

     • ペイロードの例（送信可能）
     {
     "src_file_url": "https://plugins-media.makeupar.com/strapi/assets/face_reshape_01_85c8ffc055.jpg",
     "version": "1.0",
     "source": "yco",
     "features": {
         "eye_size_left": 80,
         "eye_size_right": 80,
         "eye_width": 0,
         "eye_height": 0,
         "eye_distance": 0,
         "eye_angle": 0,
         "face_reshape_left": 0,
         "face_reshape_right": 0,
         "chin_reshape_left": 20,
         "chin_reshape_right": 20,
         "chin_length": 0,
         "face_width": -30,
         "cheekbones": 0,
         "jaw": 0,
         "lip_size": 10,
         "lip_width": 40,
         "lip_height_top": 10,
         "lip_height_bottom": 10,
         "lip_peak": -10,
         "nose_size": 30,
         "nose_lift": -20,
         "nose_bridge_width": 10,
         "nose_tip": -10,
         "nose_wing": 30,
         "nose_tip_width": 30
     },
     "global": {
         "skin_smooth_strength": 50,
         "skin_smooth_color_intensity": 50
     }
     }

3. 顔パーツ補正 AI タスクの作成と結果のポーリング

   画像と完全な効果ペイロードが用意できたら、タスクを作成します。API はリクエストを非同期で処理します。タスクステータスが success または error に達するまでポーリングする必要があります。

   • タスク作成エンドポイント

     POST /s2s/v2.0/task/face-reshape

   • ポーリングエンドポイント

     GET /s2s/v2.0/task/face-reshape/{task_id}

ファイル仕様とエラー

• AI 顔パーツ補正仕様

サポートされるセルフィービュー 画像の幅と高さの 1/20 より大きい顔の幅と高さを持つセルフィー。 ピッチ、ヨー、ロールの顔角度は 30 度未満。

顔カスタマイズパラメータガイド

注意: “左”と“右”はキャラクターの視点であり、視聴者の画面の側ではありません。

• サポートされる形式と寸法

• エラーコード

• 環境と依存関係

JS カメラキット

ユニット消費量