平拍 API

Photoroom 的 Flat Lay API 可自動將服飾商品照片轉換成簡潔俐落的俯拍平拍商品照，適用於電商和線上市集。它是 Photoroom API 中 20 多種編輯功能之一。

可以。使用 Photoroom API 時，只要傳送服裝照片，並將 flatLay.mode 設為 ai.auto，每次呼叫就會取得一張平鋪圖。你可以在速率限制內平行發送呼叫；預設每分鐘最多可處理 60 張圖片。因此，你可以將 API 串接至產品目錄或上傳流程，自動為每件新上架的服裝製作平鋪圖。

使用 Photoroom API，上傳一張服裝照片，就能取得乾淨的俯拍平鋪商品照，可直接用於電商平台和各大市集，無須再親自為服裝搭配造型、平鋪整理和拍攝。API 呼叫會平行處理，預設每分鐘可處理 60 張圖片，因此整個商品目錄都能透過同一個 API 呼叫完成處理。

針對服飾型錄，Photoroom 的 Flat Lay API 專為大量處理而打造。只需整合一次，就能將每張服裝照片轉換為平拍照，並進行 20 多種其他編輯，例如移除背景、幽靈人台和AI 熨燙。Enterprise 方案提供更高的速率限制，並為大型型錄進行輸出檢查：洽詢業務。

平拍會將服裝平放，並從上方拍攝。幽靈人台可呈現不含人台的服裝影像，展現合身度與垂墜感；虛擬模特兒則能將服裝照片轉換成以預設或自訂 AI 模特兒為主角的生活風格圖像。這三種功能都使用同一個 Photoroom API，因此整合一次即可涵蓋全部三種功能。

取得你的 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

所有參數都在Flat Lay 說明文件中。

將每張服飾照片都透過相同的 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 像素，並可取得相同格式的檔案。Flat Lay 預設會以 1K（1024 x 1024）輸出圖片；Enterprise 方案也提供 2K 和 4K 輸出。詳細資訊請參閱檔案大小、解析度與格式文件頁面。

Flat Lay 已包含在 Plus API 方案中，每月 100 美元（每張圖片 0.10 美元），也適用於 Enterprise 方案：洽詢業務。每次 API 呼叫費用為 0.10 美元，可包含任意數量的編輯選項，價格不受影響；發生錯誤的呼叫不會扣除圖片額度。你可以先在沙盒模式中測試影像編輯 API，每月可免費進行 1,000 次含浮水印的呼叫。詳情請參閱定價頁面。

是的，Photoroom 為 Claude 等 AI 助理提供 MCP 伺服器，支援 Flat Lay。如需更多資訊，請參閱 Photoroom MCP。

使用 API 時遇到問題嗎？加入我們的 API 社群，向工程師尋求協助，或查看 疑難排解頁面，了解常見問題。

如果有任何帳務相關問題，或需要提供敏感資訊，請直接在社群中私訊 Photoroom。我們很樂意協助。