コンテンツへスキップ

靴バーチャル試着

概要

靴バーチャル試着を作成します。 靴を履いた状態のプレビューを確認できます。

統合ガイド

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

  • エンドポイント: /s2s/v2.0/task/shoes
  • 認証: すべてのリクエストには Authorization: Bearer YOUR_API_KEY が必要です
  • ワークフロー:
    1. セルフィー画像の準備: バーチャル試着の対象として、自分の画像をアップロードするか、有効な画像 URL を指定します。
    2. 靴画像の準備: 靴の商品画像または靴を履いた人物の写真をアップロードします。
    3. スタイルと性別の選択: 希望するスタイルと、視覚化したい性別を選択します。
    4. AI タスクの実行とタスク ID の取得: レスポンスから task_id を取得します。
    5. ステータスのポーリング (GET): task_id を使用してタスクのステータスを確認します。task_status が "success" または "error" になるまでポーリングを続けます。
  • 認証
  • リクエストヘッダーに Bearer トークン を使用して API キーを含めます:
Authorization: Bearer YOUR_API_KEY

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

  • AI 靴 API 使用ガイド

このガイドでは、画像のアップロード、参照用靴の準備、および AI 靴 API を使用したバーチャル試着タスクの作成方法について説明します。

  • ステップ 1. セルフィー画像の準備

以下のいずれかの方法が可能です:

  • File API (/s2s/v2.0/file) を使用してセルフィー画像をアップロードする、または

  • 有効な画像 URL を指定する。

    • ステップ 1.1 File API を使用したファイルのアップロード

File API (/s2s/v2.0/file) を使用して、対象ユーザーの画像をアップロードします。

画像要件:

  • セルフィー写真をアップロードします。
  • 写真に上半身がはっきりと写っていることを確認してください。
  • 複数の人物や気が散るオブジェクトがある背景は避けてください。

リクエスト例:

curl --request POST \
  --url https://yce-api-01.makeupar.com/s2s/v2.0/file \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{
    "files": [
      {
        "content_type": "image/jpg",
        "file_name": "selfie_photo_01_3dbd1b6683.jpg",
        "file_size": 547541
      }
    ]
  }'
  • ステップ 1.2. File API レスポンスの取得

レスポンスには以下が含まれます:

  • AI タスク作成用の file_id。
  • 実際の画像ファイルをアップロードするための requests.url。

レスポンス例:

{
  "status": 200,
  "data": {
    "files": [
      {
        "content_type": "image/jpg",
        "file_name": "selfie_photo_01_3dbd1b6683.jpg",
        "file_id": "SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9/13W5TOD8/u/FfjK3xgCQ+hRt9MJXBFaud",
        "requests": [
          {
            "method": "PUT",
            "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...",
            "headers": {
              "Content-Length": "547541",
              "Content-Type": "image/jpg"
            }
          }
        ]
      }
    ]
  }
}
  • ステップ 1.3. 指定された URL への画像アップロード

File API レスポンスの requests.url を使用して画像をアップロードします:

curl --location --request PUT 'https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...' \
  --header 'Content-Type: image/jpg' \
  --header 'Content-Length: 547541' \
  --data-binary @'./selfie_photo_01_3dbd1b6683.jpg'
  • ステップ 2. 参照用靴画像の準備

以下のいずれかの方法が可能です:

  • File API (/s2s/v2.0/file) を使用して靴画像をアップロードする、または
  • 有効な画像 URL を指定する。

サポートされる靴画像:

  • 靴の商品画像。
  • 靴を履いた人物の写真。

詳細な仕様については、ファイル仕様とエラー を参照してください。

  • ステップ 3. AI タスクの作成

希望するスタイルと、視覚化したい性別を選択します。 AI タスク API (/s2s/v2.0/task/shoes) を使用して、バーチャル試着タスクを作成します。

パラメータ:

  • ユーザー画像用: src_file_id または src_file_url。
  • 靴画像用: ref_file_id または ref_file_url。

リクエスト例:

curl --request POST \
  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/shoes \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{
    "src_file_url": "https://example.com/selfie.jpg",
    "ref_file_url": "https://example.com/accessory.jpg",
    "gender": "female",
    "style": "random"
}'

レスポンス例:

{
  "status": 200,
  "data": {
    "task_id": "SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9_13W5TOD8_u_GPi6NqQ3dhlmN-6ntFwhzT"
  }
}
  • ステップ 4. タスク結果のポーリング

タスク ID を使用してステータスを確認します:

curl --request GET \
  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/shoes/SaGaqpDgKwFrVBgMpQMA3HY0LeqdT9_13W5TOD8_u_GPi6NqQ3dhlmN-6ntFwhzT \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json'
  • ステップ 5. 結果の取得

成功したレスポンスには、結果画像のダウンロード URL が含まれます:

{
  "status": 200,
  "data": {
    "error": null,
    "results": {
      "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature..."
    },
    "task_status": "success"
  }
}

無効な API キーのエラーレスポンス:

{
  "status": 401,
  "error": "Unauthorized",
  "error_code": "InvalidAccessToken"
}

ファイル仕様とエラー

  • AI 靴バーチャル試着仕様

    • 画像要件
種類最小解像度備考
セルフィー512 × 512顔が見えること、頭から胸までが推奨
靴512 × 512 (商品)
800 × 800 (着用)		靴がはっきりと、遮られずに写っていること

サポートされる靴画像

  • 商品画像の要件
    • 最小解像度: 512 × 512 ピクセル
    • 画像あたり 1 つの製品のみ
    • 製品は画像の高さの 25% 以上を占める必要があります

  • 着用画像の要件
    • 最小解像度: 800 × 800 ピクセル
    • 単一アイテム要件: モデルは正確に 1 つのアイテムのみを着用している必要があります。複数のアイテムやアクセサリーは許可されません。
    • カバレッジ比率: 着用アイテムは画像全体の height の 20% 以上を占める必要があります。これにより、アイテムがフレーム内で明確に見え、目立つことが保証されます。

サポートされるセルフィービュー

  • 推奨画像解像度: 少なくとも 512 × 512 ピクセル。
  • 推奨顔のカバレッジ: 画像の高さの 15% 以上。
  • 単一被写体要件: 画像には正確に 1 人の人間の被写体のみが含まれている必要があります。追加の人物や部分的な人物像は許可されません。
  • 顔の可視性: 被写体の顔が完全に視認可能で、遮られていない必要があります。髪、アクセサリー、またはオブジェクトが主要な顔の特徴を覆ってはいけません。
  • フレーミング: 画像には少なくとも頭部ショットを含み、頭頂部から胸までの領域をカバーする必要があります。最適な分析のためには、半身ショット（頭から腰まで）が推奨されます。

試着スタイル

  • バーチャル試着出力の生成には、"style_minimalist" "style_bohemian" "style_cottagecore" "style_french_elegance" および "style_retro_fashion" の 5 つの事前定義されたスタイルがあります。AI タスク作成時にこの style パラメータを指定するか、デフォルトでシステムがランダムにスタイルを選択させることができます。

style_bohemian

  • サポートされる形式と寸法
AI 機能サポートされる寸法サポートされるファイルサイズサポートされる形式
AI 靴バーチャル試着入力: 長辺 <= 4096
出力: 1008 x 1344		< 10MBjpg/jpeg/png/heic
  • エラーコード
エラーコード説明
error_download_imageソースまたは参照画像のダウンロードに失敗しました
error_inference推論パイプラインエラー
error_no_faceソース画像で顔が検出されませんでした
error_nsfw_content_detected結果に NSFW コンテンツが検出されました
exceed_max_filesizeファイルサイズが 10 MB を超えています
invalid_parameter無効な gender または style 値
unknown_internal_errorその他の内部エラー
  • 環境と依存関係
サンプルコード言語 / ツール推奨ランタイムバージョン
cURL- bash >= 3.2
- curl >= 7.58 (モダンな TLS/HTTP サポート)
- jq >= 1.6 (堅牢な JSON パーシング)
Node.js (JavaScript)Node >= 18 (グローバル fetch 用)
JavaScript- Chrome / Edge >= 80
- Firefox >= 74
- Safari >= 13.1
PHPPHP >= 7.4 (モダンな TLS/互換性用), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json
PythonPython >= 3.10 (f-strings 用), requests >= 2.20.0
JavaJava 11+ (HttpClient 用), Jackson Databind >= 2.12.0

ユニット消費

AI 機能消費ユニット
AI 靴バーチャル試着 V2.02
OpenAPI記述をダウンロード
ai_shoes.json
ai_shoes.yaml
概要
メール
YouCamOnlineEditor_API@perfectcorp.com
ライセンス
Privacy policy
利用規約
言語
サーバー
https://yce-api-01.makeupar.com