ゴーストマネキンAPI

PhotoroomのゴーストマネキンAPIを使うと、衣類の写真からマネキンの写らない、フィット感や生地の落ち感が伝わる商品写真を作成できます。この表現は「インビジブルマネキン」とも呼ばれます。これは、Photoroom APIに含まれる20種類以上の編集機能の1つです。

ゴーストマネキンを有効にして、写真を1枚ずつPhotoroom APIに送信すると、マネキンを除去した完成画像が返されます。ゴーストマネキンは、衣類商品が写った画像での使用を想定しています。API呼び出しのコード例は以下のとおりです。

Photoroom APIでは、商品写真をすっきり仕上げるゴーストマネキンと、衣類の写真をあらかじめ設定されたAIモデルまたはカスタムAIモデルを使ったライフスタイル画像に変換するAIバーチャルモデルの両方に対応しています。1つのAPI連携で、この2つに加え、平置き、AIシワ補正、背景除去にも対応しています。

カタログまたはアップロードのフローをPhotoroom APIに接続し、1回のAPI呼び出しにつき衣類の写真を1枚送信します。呼び出しを並列で実行すると、デフォルトで1分あたり最大60枚を処理できます。大量の商品カタログ向けには、Enterpriseプランで上限を引き上げられます。営業担当にお問い合わせください。

ゴーストマネキンは、月額100ドル（画像1枚あたり0.10ドル）のPlus APIプランと、Enterpriseプランに含まれています。詳しくは営業にお問い合わせください。1回のAPI呼び出しの料金は、組み合わせる編集の数にかかわらず同じです。エラーが返された呼び出しでは画像を消費しません。まずはサンドボックスモードで、透かし入りの画像を返すAPI呼び出しを月1,000回まで無料でお試しいただけます。詳細は料金ページをご覧ください。

APIキーを取得してから、ghostMannequin.modeをai.autoに設定し、衣類の写真を送信してください。

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form ghostMannequin.mode=ai.auto \
  --output result.png

すべてのパラメーターは、ゴーストマネキンのドキュメントに記載されています。

ゴーストマネキンを使用するには、ghostMannequin.modeをai.autoに設定します。

ghostMannequin.size: 生成画像の出力サイズと縦横比です。デフォルトは SQUARE_HD です。その他の値は PORTRAIT_HD_16_9、PORTRAIT_HD_4_3、PORTRAIT_HD_3_2、LANDSCAPE_HD_3_2、LANDSCAPE_HD_4_3、LANDSCAPE_HD_16_9 です。

ghostMannequin.prompt: 生成スタイルを指定するための任意のテキストプロンプトです。例：ゴーストマネキン。

最大30 MB、長辺5,000ピクセルまでのPNG、JPEG、WEBP、AVIF形式のファイルをアップロードすると、同じ形式で出力されます。ゴーストマネキンでは、デフォルトで1K（1024 x 1024）の画像が出力されます。Enterpriseプランでは、2Kおよび4Kの出力解像度を利用できます。詳しくは、ファイルサイズ、解像度、形式のドキュメントをご覧ください。

はい。Photoroomには、ClaudeなどのAIアシスタント向けのMCPサーバーがあります。対応しているツールについては、Photoroom MCPをご覧ください。

APIでお困りですか？APIコミュニティに参加してエンジニアに相談するか、よくある問題についてはトラブルシューティングページをご確認ください。

請求に関することや機密情報を含む内容については、コミュニティ内でPhotoroomに直接DMをお送りください。いつでもサポートいたします。