ガイド · ゴーストマネキン

ゴーストマネキンAPIとは？インビジブルマネキン写真

要約

ゴーストマネキンAPIは、マネキンに着せた衣服の写真を受け取り、マネキンを除去して内側を再構成した同じ衣服の画像を返すことで、衣服自体が自立した立体形状を保っているように見せます。

所要時間の目安: 1.5–4 min
Credits: 2Kで4 credits · 4Kで5 credits
処理方式: 非同期、ポーリング

このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み 2026-09-10

要点

ゴーストマネキン撮影 — ホローマネキンやインビジブルマネキンとも呼ばれる — は、内部に人体がない状態で衣服自体の立体形状を保持して見せる手法です。従来はスタジオで複数カットを撮影し、マネキンに着せた衣服の画像からマネキンを除去した上で、襟の内側や袖口のパーツを合成するポストプロセスで作成されていました。

ゴーストマネキンAPIは、これを1回のリクエストで実行します。マネキン着用の写真を送信すると、サービスがマネキンを除去し、襟の内側・袖口の裏地・ウエストバンドなど、衣服の内側として見えるべき構造を再構築して完成画像を返します。try-onと同様、コールは非同期（送信、polling、ダウンロード）です。

アパレルの商品詳細ページにおける標準的な処理手法であるため、衣服ごとにスタジオ撮影を組むことなく、何千点もの商品全体で一貫したルックを必要とするカタログチームやマーケットプレイスに利用されています。

処理を実行するエンドポイント

手書きではなく、Photta APIドキュメントから直接読み込んだ内容です。

概要

エンドポイント: POST /api/v1/ghost-mannequin
認証: Bearer APIキー
処理方式: 非同期 — ステータスエンドポイントをポーリング
所要時間の目安: 1.5–4 min
Credits: 2Kで4 credits · 4Kで5 credits
アスペクト比: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
入力制限: 1画像あたり最大10 MB、JPEG, PNG, WebP
冪等性: なし

ゴーストマネキンAPIの選定ポイント

リクエストに含めるデータ
マネキンに着用させた衣服の写真、および任意で背面写真。Phottaは1画像あたり最大10 MBのJPEG、PNG、WebPを受け付けます。
出力の仕上がり
Phottaのエンドポイントはstyleパラメータを受け取ります：3dは衣服の立体的なボリュームを維持し、flat_layはフラットで整った平置き構図に変換します。
利用料金
Phottaでは2K解像度で4 credits、4Kで5 creditsです — 各ティアともtry-onより1 credit安く設定されており、ジョブがfailedとなった場合は自動で返金されます。
バッチ処理の可否
カタログ運用の作業は単発ではなくラック単位で発生します。Phottaには配列を受け付け、事前にcreditsを確保し、アイテム単位でステータスをレポートするバッチエンドポイントがあります。

最初のリクエスト

cURL、Node.js、Pythonでの同一リクエスト例。

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
    "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
    "image_side": "front",
    "angle": "side",
    "style": "3d",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "user_instruction": "closed front, cream interior lining",
    "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/ghost-mannequin",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
      "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
      "image_side": "front",
      "angle": "side",
      "style": "3d",
      "background_color": "white",
      "resolution": "2K",
      "aspect_ratio": "3:4",
      "user_instruction": "closed front, cream interior lining",
      "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

ゴーストマネキンAPIに関するFAQ

ゴーストマネキン写真とは何ですか？

人体やハンガーが見えず、衣服が立体的な形状を維持したまま浮いているように見える商品写真です。シルエットと内側の構造を同時に確認できるため、アパレルの商品ページにおける標準仕様となっています。

エンドポイントには何を送信しますか？

マネキンに着せた衣服の写真です。背面写真は任意ですが、前開きやリバーシブルの衣服において再構築の精度が向上します。

3dとflat_layのどちらを選択すべきですか？

着用時のボリューム、肩のライン、袖の立体感を見せたい場合は3dを選択してください。マーケットプレイスで一般的な、正面向きの均一な形状が求められる出品規格の場合はflat_layを選択します。

画像1枚あたりのコストはいくらですか？

Phottaでは2Kで4 credits、4Kで5 creditsです。バッチ処理の場合も同様の1枚あたり料金が実行全体に対して事前確保されます。

カタログ全体を一括処理できますか？

はい、バッチエンドポイント経由で処理可能です。バッチサイズおよび同時実行可能なバッチ数はご契約のplansに応じるため、大規模なカタログは連続したバッチとして実行します。

次に読む

このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み 2026-09-10

1着の衣服で実際に実行する

1枚の写真を入力し、1枚のインビジブルマネキン写真を出力。

アカウントを作成してAPIキーを取得エンドポイントを見る

1.5–4 min
2Kで4 credits · 4Kで5 credits
非同期、ポーリング

ゴーストマネキンAPIとは？ インビジブルマネキン写真

要点