笑顔補正

統合ガイド

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

AI 笑顔補正 のワークフロー:

エンドポイント: /s2s/v2.0/task/ai-smile

認証必須: Authorization: Bearer YOUR_API_KEY

ワークフロー手順:

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

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

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

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

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

   • 取得した task_id を使用して、HTTP GET リクエスト（例: GET /s2s/v2.0/task/ai-smile/${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. AI 笑顔タスクの作成と結果のポーリング

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

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

     POST /s2s/v2.0/task/ai-smile

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

     GET /s2s/v2.0/task/ai-smile/{task_id}

ファイル仕様とエラー

• AI 笑顔仕様

サポートされる自撮りビュー 単一人物の画像のみサポートされます。画像には、長辺が 640 ピクセルの場合に 32 x 32 ピクセルを超える十分なサイズの顔が明確に写っている必要があり、顔検出の失敗を避けるため、撮影角度はロールがプラスマイナス 75 度以内、ヨーがプラスマイナス 90 度以内である必要があります。

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

• エラーコード

• 環境と依存関係

ユニット消費