AI 肌改善シミュレーション

統合ガイド

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

AI 肌改善シミュレーション API のワークフロー：

エンドポイント: /s2s/v2.0/task/skin-simulation

認証必須: Authorization: Bearer YOUR_API_KEY

ワークフロー手順:

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

   • プロセスはセルフィー画像の準備から始まります。

2. AI 肌改善シミュレーション設定 各肌悩み（例：しわ、毛穴、赤み）について、シミュレーション強度を 0.0 から 1.0 の値で調整します：

   • 0.0: 元の肌の外観を表示します—変更なし。
   • 1.0: その悩みに対して AI が生成できる最も自然で健康的に見える強化を適用します。

   仕組み:

   • 低い設定（例：0.2～0.4）では、細かいしわや軽微な欠陥が微妙に緩和されます。
   • 高い設定（例：0.7～1.0）では、中程度または深いしわの大幅な軽減、滑らかな質感、トーンの改善など、より顕著な改善が、自然な肌のディテールを保持しながらも発生します。

   望ましい見た目になるまで調整してください。

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

   • アップロードした画像と肌シミュレーション設定を HTTP POST リクエストで /s2s/v2.0/task/skin-simulation に送信します。
   • このやり取りを識別する一意のタスク ID をレスポンスで待ちます。

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

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

• 認証

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

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

• 画像のアップロード

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

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

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

• AI 肌改善シミュレーション強度の調整 AI 肌改善シミュレーション設定

各肌悩み（例：しわ、毛穴、赤み）について、シミュレーション強度を 0.0 から 1.0 のスケールで調整します：

• 0.0 → 元の外観 — AI 強化は適用されません。
• 1.0 → その悩みに対する最大限の改善。

異なる強度レベルでの期待効果：

低め（例：0.2）から開始して調整します。

• AI 肌改善シミュレーション AI タスクの作成と結果のポーリング

画像をアップロードし、少なくとも 1 つの肌悩みのシミュレーション強度を 0.0 以上に設定した後、タスクを開始できます。API はリクエストを非同期で処理します。ステータスが success または error に達するまで、タスクステータスをポーリングする必要があります。

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

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

ファイル仕様とエラー

• AI 肌改善シミュレーション仕様

カメラと撮影ガイドライン

ライティング条件 環境が十分に明るく、均一に照明されていることを確認してください。強い逆光、局所的な露出オーバー、顔への大きな影を避けてください。可能な限り自然光または柔らかい屋内照明を使用してください。ピンク、ブルー、その他の色付き光源など、有色光は肌の色調の表現を歪める可能性があるため使用しないでください。

顔の位置と遮蔽 顔がカメラを直接向いている正面からのビューを撮影してください。頭の回転は最小限に抑え、過度な傾きや左右への向きを避けてください。額、頬、あごを含む顔全体が完全に可視であり、遮蔽されていないことを確認してください。髪、マスク、手、メガネのフレーム、携帯電話、または顔の特徴を部分的に覆うその他のオブジェクトは使用しないでください。

表情とポーズ 両目を開いた自然でリラックスした表情を保ってください。口は閉じたままでもわずかに開いていても構いませんが、ポーズを無理にしたり誇張したりしないでください。

フレーム内の顔サイズ 正確な分析に必要な十分なディテールを確保するために、顔は画像幅の少なくとも 60% を占める必要があります。被写体が小さすぎる、遠すぎる、または不適切にフレーミングされている画像の撮影は避けてください。

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

• エラーコード

• 環境と依存関係

JS Camera Kit

ユニット消費

• 肌シミュレーション