平置きAPI

Photoroomの平置きAPIは、衣類の商品写真を、ECサイトやマーケットプレイスですぐに使える、すっきりとした真上からの平置き画像に自動変換します。これはPhotoroom APIで利用できる20以上の編集機能の一つです。

はい。Photoroom APIでは、flatLay.modeをai.autoに設定して衣類の写真を送信すると、1回のリクエストにつき平置き画像を1枚取得できます。デフォルトのレート制限は毎分60枚で、上限内であれば複数のリクエストを並行して処理できるため、商品カタログやアップロードのフローに連携し、新しい衣類を自動で平置き画像に変換できます。

Photoroom APIを使えば、衣類の写真を送信するだけで、ECサイトやマーケットプレイスにすぐ使える、すっきりとした真上からの平置き商品画像を取得できます。衣類のスタイリングや配置、撮影を手作業で行う必要はありません。API呼び出しは並列で処理され、デフォルトで毎分60枚に対応するため、同じAPI呼び出しを使ってカタログ全体を処理できます。

アパレルカタログ向けのPhotoroomの平置きAPIは、大量処理を前提に設計されています。1回の連携で、衣類写真を平置きの商品画像に整えられるほか、背景除去、ゴーストマネキン、AIシワ補正など20種類以上の編集機能を利用できます。Enterpriseプランでは、大規模な商品カタログ向けに、より高いレート制限と出力チェックを利用できます。営業にお問い合わせください。

平置きでは衣服を平らに置き、上から撮影した画像を作成します。ゴーストマネキンではマネキンを使わずに衣服を表示し、フィット感やドレープを表現します。バーチャルモデルでは、衣服の写真を、あらかじめ用意されたAIモデルまたはカスタムAIモデルを使ったライフスタイル画像に変換します。3つとも同じPhotoroom APIで動作するため、1つの連携ですべてに対応できます。

APIキーを取得してから、flatLay.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 flatLay.mode=ai.auto \
  --output result.png

すべてのパラメーターは平置きのドキュメントに記載されています。

すべての衣類写真を、同じ設定で同じPhotoroom APIリクエストに送信します。変更できる設定は次のとおりです：

• 平置きを使用するには、flatLay.modeをai.autoに設定してください。

• flatLay.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です。

• flatLay.prompt: 生成スタイルを指定する任意のテキストプロンプトです。たとえば、清潔感のあるスタジオで商品を平置きしたスタイルなどです。

PNG、JPEG、WEBP、AVIF形式のファイル（最大30MB、最長辺5,000ピクセル）を送信すると、同じ形式で受け取れます。平置きでは、デフォルトで1K（1024 x 1024）の画像が出力されます。Enterpriseプランでは、2Kと4Kでの出力も利用できます。詳細については、ファイルサイズ、解像度、形式のドキュメントをご覧ください。

平置きはPlus APIプラン（月額100ドル、画像1枚あたり0.10ドル）とEnterpriseプランに含まれています。営業担当にお問い合わせください。1回の呼び出しは0.10ドルで、編集オプションはいくつでも追加でき、料金は変わりません。エラーが返された呼び出しでは画像を消費しません。Image Editing APIは、サンドボックスモードで月1,000回まで、透かし入り画像を返す無料の呼び出しを利用して事前にお試しいただけます。詳細は料金ページをご覧ください。

はい。Photoroomには、ClaudeなどのAIアシスタント向けに平置きに対応したMCPサーバーがあります。詳しくはPhotoroom MCPをご覧ください。

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

請求に関するお問い合わせや機密情報を含む内容については、コミュニティ内でPhotoroomに直接DMでご連絡ください。いつでも喜んでサポートいたします。