隱形人台 API

Photoroom 的幽靈人台 API 可將服飾照片轉換成乾淨俐落、無人台的商品照，清楚呈現服裝的版型與垂墜感；這種效果也稱為「隱形人台」。這是 Photoroom API 中 20 多種編輯功能之一。

將每張照片分別傳送至 Photoroom API，並啟用 Ghost Mannequin；每次 API 呼叫處理一張圖片，完成後就會收到移除人台的圖片。Ghost Mannequin 適用於包含服飾的圖片。API 呼叫方式請見下方程式碼範例。

Photoroom API 同時提供兩種功能：以隱形人台拍攝呈現俐落的服裝商品照，以及透過 虛擬模特兒，將服裝照片轉換成搭配預設或自訂 AI 模特兒的生活風格照。只需一次整合，就能使用這兩種功能，還包括 平拍、AI 熨燙和移除背景。

將你的產品目錄或上傳流程串接至 Photoroom API，每次呼叫傳送一張服飾照片，並平行執行多次呼叫；預設每分鐘最多可處理 60 張圖片。Enterprise 方案可提高此上限，以支援大量產品目錄：洽詢銷售團隊。

Plus API 方案包含隱形人台功能，每月 100 美元（每張圖片 0.10 美元）；Enterprise 方案也包含此功能：洽詢業務。無論一次呼叫結合哪些編輯，費用都相同；若呼叫回傳錯誤，也不會扣除圖片額度。你可以先在沙盒模式中測試，每月可免費進行 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：用來引導生成風格的選填文字提示，例如 幽靈人台。

可上傳最大 30MB、最長邊不超過 5,000 像素的 PNG、JPEG、WEBP 或 AVIF 檔案，並以相同格式取得輸出。幽靈人台預設會以 1K（1024 x 1024）解析度輸出圖片。Enterprise 方案另提供 2K 和 4K 輸出解析度。詳情請參閱檔案大小、解析度與格式說明文件。

是的。Photoroom 提供 MCP 伺服器，供 Claude 等 AI 助理使用；請參閱 Photoroom MCP，了解其支援的工具。

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

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