平铺拍摄 API

Photoroom 的平铺 API 可自动将服装单品照片转换为干净利落的俯拍平铺图，可直接用于电商和各类线上平台。它是 Photoroom API 中 20 多种编辑功能之一。

是的。使用 Photoroom API 时，你只需发送一张服装照片，并将 flatLay.mode 设置为 ai.auto，即可获得平铺效果图；每次调用返回一张图片。调用可以并行执行，但不能超过速率限制，默认限制为每分钟 60 张图片。这样，你就能将 API 接入产品目录或上传流程，自动将每件新服装处理成平铺效果图。

使用 Photoroom API，只需发送一张服装单品照片，即可获得干净规整的俯拍平铺图，可直接用于电商网站和各类交易平台，无需手动为服装搭配造型、摆放和拍摄。API 调用默认并行运行，每分钟可处理 60 张图片，因此整个商品目录都可以通过同一调用处理。

对于服装产品目录，Photoroom 的平铺 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 套餐也包含此功能：联系销售团队。每次调用收费 0.10 美元，编辑选项数量不限，价格不受影响；返回错误的调用不会消耗图片额度。你可以先在沙盒模式下测试图像编辑 API，每月可免费调用 1,000 次（带水印）。详情请见定价页面。

是的。Photoroom 为 Claude 等 AI 助手提供 MCP 服务器，支持 Flat Lay。了解详情，请参阅 Photoroom MCP。

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

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