豊胸シミュレーター

統合ガイド

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

AI 豊胸シミュレーター API のワークフロー：

エンドポイント: /s2s/v2.0/task/breast-shape

認証必須: Authorization: Bearer YOUR_API_KEY

ワークフロー手順:

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

   • プロセスはバストショットのセルフィーを準備することから始まります。

2. AI 豊胸シミュレーター設定 AI 豊胸シミュレーターでは、1（控えめ）から 3（顕著）までの強度レベルを調整して補正の度合いを制御します。

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

   • アップロードした画像とパラメータ設定を HTTP POST リクエストで /s2s/v2.0/file に送信します。
   • このインタラクションを識別する一意のタスク ID をレスポンスで待ちます。

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

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

• 認証

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

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

• 画像のアップロード

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

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

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

• AI 豊胸シミュレーター強度の調整 AI 豊胸シミュレーター設定

AI 豊胸シミュレーターでは、強度レベルを 1 から 3 の間に設定して補正の度合いを制御します。

• レベル 1: 控えめな補正。
• レベル 2: 中程度の補正。
• レベル 3: 顕著な補正。

• AI 豊胸シミュレーター AI タスクの作成と結果のポーリング

画像をアップロードし、希望する強度レベルを選択した後、補正タスクを開始できます。API はリクエストを非同期で処理します。タスクステータスが success または error に達するまでポーリングする必要があります。

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

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

ファイル仕様とエラー

• AI 豊胸シミュレーター仕様 最適な結果のための画像要件と推奨事項

• 解像度ガイドライン: 入力画像の最長辺は 4096 ピクセルを超えてはなりません。最高のパフォーマンスを得るには、頭頂部から胸部を含む上半身領域が、少なくとも 1024 × 768 ピクセルの解像度でレンダリングされていることを確認してください。

• 被写体要件:

  • 画像には少なくとも 1 人の完全に検出可能な人物が含まれている必要があります。両肩がフレーム内で明確に視認できる必要があります。
  • 胸部領域が視認可能である必要があります。これには、被写体が主に正面を向いている場合（つまり、ヨー角が −90° から +90° の間）、衣服を着用している場合と着用していない場合の両方が含まれます。斜めや横顔のポーズよりも、正面からのビューが強く推奨されます。

• 結果向上のための推奨プラクティス:

  • 上半身構図を優先してください：画像は上半身に特化しているか、全身が含まれている場合でも、上半身領域がフレームの大部分を占め、最長辺が 1024 ピクセルを超えている必要があります。
  • 正面のポーズのみを使用してください。検出精度と結果の品質が低下するため、横向きや大きく回転した位置は避けてください。
  • 胸部輪郭の最も自然な補正を得るには、水着、低カットトップス、V ネックウェアなど、バスト周辺の肌を露出させる服装を選択してください。これらのスタイルにより、AI は下層構造をよりよく推測し、控えめでリアルなデコルテ効果を生み出すことができます。
  • システムは単一被写体の画像のみをサポートします。フレーム内に複数の人物がいる場合、処理は自動的に最も大きな可視肩幅を持つ個人（つまり、カメラに最も近い、または最も中央に整列している人物）を対象とします。
  • 胸部領域上の遮蔽を避けてください。バッグ、バックパックストラップ、スカーフ、ネックレス、その他のアクセサリーなどのオブジェクトは、誤って除去されたり、編集時にアーティファクトを引き起こしたりする可能性があります。
  • 衣服の外観は元の画像と異なる場合があります。補正の度合いは強度設定に依存します：補正レベルが高いほど、胸部周辺の衣服の形状、フィット感、ドレープの顕著な変更など、より顕著な変化が生じます。

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

• エラーコード

• 環境と依存関係

ユニット消費