フェイスリフト

統合ガイド

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

AI フェイスリフト API のワークフロー:

エンドポイント: /s2s/v2.0/task/face-lift

認証必須: 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-lift に送信します。
   • この操作を識別するための一意なタスク ID をレスポンスで待ちます。

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

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

1. 認証

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

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

2. 画像のアップロード

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

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

     POST /s2s/v2.0/file

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

3. 前処理により補正対象の顔を選択する

   • 前処理 API の呼び出し ピクセル座標で検出されたバウンディングボックスを出力します。後で Face Lift AI タスクを作成するために、結果のインデックスを使用します。

     POST /s2s/v2.0/task/face-lift/pre-process

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

4. Face Lift AI タスクの作成と結果のポーリング

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

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

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

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

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

ファイル仕様とエラー

• AI フェイスリフト仕様

対応セルフィービュー 画像は 1920 x 1920 以下で、長辺が 640 のときに 32 x 32 ピクセルを超える十分なサイズの顔がはっきりと写っており、ロール角度がプラスマイナス 75 度以内、ヨー角度がプラスマイナス 90 度以内で撮影されている必要があります。

• 対応フォーマットと寸法

• エラーコード

• 環境と依存関係

JS Camera Kit

ユニット消費量