幽灵人台 API

Photoroom 的隐形人台 API 可将服装照片转换为干净利落、不带人台的商品图，清晰呈现服装的版型和垂坠感，这种效果也称为“隐形人台效果”。它是 Photoroom API 中 20 多种编辑功能之一。

启用 Ghost Mannequin 后，将每张照片分别发送到 Photoroom API（每次调用处理一张图片），即可获得去除人台后的成品图片。Ghost Mannequin 适用于包含服装的图片。具体调用见下方代码示例。

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 文件，即可获得相同格式的图片。默认情况下，Ghost Mannequin 会以 1K（1024 x 1024）分辨率返回图片。Enterprise 套餐可使用 2K 和 4K 输出分辨率。详情请参阅 文件大小、分辨率和格式文档页面。

是的。Photoroom 为 Claude 等 AI 助手提供 MCP 服务器：查看 Photoroom MCP，了解其支持的工具。

使用 API 时遇到问题？加入我们的 API 社区，向我们的工程师寻求帮助，或查看 故障排查页面，了解常见问题。

如果涉及账单或敏感信息，请直接在社区私信 Photoroom。我们很乐意为你提供帮助。