ゴーストマネキン · 機能
ゴーストマネキン API — Photta
衣服の写真からマネキンを取り除き、縫い目、裏地、タグなどの内部構造を完全に維持します。中空または平置き仕上げ、一括処理対応。2K で 4 credits です。
要約
PhottaのゴーストマネキンAPIは、マネキン着用の衣服写真を受け取り、衣服の内部を再構築した透明マネキン画像を返します。`/api/v1/ghost-mannequin` に `product_image_url`, `style` (hollow_man または flat_lay), `resolution` を含めて POST します。ステータスが `completed` になるまで `/api/v1/ghost-mannequin/:id` を3秒ごとにポーリングします。
curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image_url": "https://example.com/tshirt-on-model.jpg",
"style": "hollow_man",
"resolution": "2K"
}'期待される結果
Typical completion
1–3min
2K / 4K credits
4 / 6
Styles
2
Batch-ready
yes
エンドツーエンドのコード
言語を選択
RESTの仕様は同じです。ゴーストマネキンエンドポイントは、大量のカタログ処理のためのバッチ処理もサポートしています。
仕組み
写真1枚を投入し、透明マネキン写真1枚を出力
ソースをアップロードし、スタイルを選択、送信、ポーリング、ダウンロード。
- 01
ステップ 1
APIキーを生成する
ゴーストマネキンは他のPhotta機能と同じ認証情報を使用します。1つのキー、1つのクレジット残高です。
- 02
ステップ 2
ソース写真をアップロードする
`product_image_url` に公開URLを渡すか、`/api/v1/uploads` 経由で直接アップロードできます。JPG, PNG, WebP に対応しています。
- 03
ステップ 3
ゴーストマネキンジョブを POST する
`/api/v1/ghost-mannequin` に `product_image_url`, `style` (hollow_man または flat_lay), `resolution` を含めて POST します。完了時に通知を受け取りたい場合は `webhook_url` を渡すことも可能ですが、基本はポーリングで対応します。
- 04
ステップ 4
完了までポーリングする
3秒ごとに GET `/api/v1/ghost-mannequin/:id` を実行します。人物をレンダリングする必要がないため、試着よりも高速（通常 1 から 3 分）です。
- 05
ステップ 5
ダウンロードと保存
出力はマネキンが除去され、衣服の内部が再構築された PNG です。商品詳細ページのゴーストショット、3D感のあるギャラリー、平置きインサートに最適です。
開発者からのよくある質問
ゴーストマネキン導入前に開発者が抱く疑問
ゴーストマネキン写真とは何ですか？+
衣服が透明な体の上に浮いているように見せ、形状と内部構造を同時に見せる商品写真の手法です。従来は複数のスタジオショットを合成していましたが、PhottaのAPIはマネキン着用の写真1枚から一度のコールで生成します。
ゴーストマネキンの料金はいくらですか？+
2K で 4 credits、4K で 6 credits です。試着よりも各ティアで1クレジット安くなっています。失敗したジョブは自動的に返金されます。
hollow-man と flat-lay スタイルの違いは何ですか？+
hollow-man はマネキンの3D体型を維持します。衣服のボリューム、肩、袖が自然に見え、内部が再構築されます。flat-lay は衣服をクリーンな2D配置に畳み込み、カプセルコレクションや、一定の正面形状を求めるマーケットプレイスへの掲載に最適です。
複数の写真を一括処理できますか？+
はい。ソース画像の配列を `/api/v1/ghost-mannequin/batch` に POST してください。レスポンスとしてバッチIDと個別の生成IDが返されます。`/api/v1/ghost-mannequin/batch/:id` で全体のステータスを確認するか、各アイテムを個別に確認できます。
内部の縫い目やラベルは保持されますか？+
はい。モデルは汎用的な表面を生成するのではなく、衣服の内側（襟の内側、袖口、ウエストバンドの裏地など）を再構築します。元の写真に見えているタグやプリントラベルも可能な限り保持されます。
結果のポーリング方法は？+
3秒ごとに GET `/api/v1/ghost-mannequin/:id` を実行します。バッチジョブの場合は、全体のステータスと各アイテムの内訳を返す親エンドポイントをポーリングします。
ゴーストマネキン · 機能
アカウントを作成してAPIキーを取得
PhottaのゴーストマネキンAPIは、マネキン着用の衣服写真を受け取り、衣服の内部を再構築した透明マネキン画像を返します。`/api/v1/ghost-mannequin` に `product_image_url`, `style` (hollow_man または flat_lay), `resolution` を含めて POST します。ステータスが `completed` になるまで `/api/v1/ghost-mannequin/:id` を3秒ごとにポーリングします。