AI 图像编辑 API

图像编辑 API 只需一次请求，就能借助 AI 编辑产品照片。发送图片和所需的编辑操作，例如移除背景、生成 AI 背景、添加阴影、重新布光、调整尺寸等。编辑完成后，图片会直接返回。此 API 专为电商团队打造，无论是编辑单张照片还是整个产品目录，都能轻松应对。

是的。一次调用即可移除背景、添加 AI 阴影、设置边距、调整尺寸，并按所需格式导出。你可以将每项编辑设为一个参数，这样同一次调用就能以相同方式处理产品目录中的每张图片。

从控制面板获取 API 密钥，然后发送包含图片的 POST 请求。以下示例会生成一张白底、带柔和阴影的商品图：

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header "x-api-key: $PHOTOROOM_API_KEY" \
  --header "pr-ai-shadows-model-version: 2026-04-15" \
  --form imageFile=@/absolute/path/to/image.jpg \
  --form background.color=FFFFFF \
  --form padding=0.15 \
  --form shadow.mode=ai.auto-with-overrides \
  --form outputSize=1600x1600 \
  --form export.format=jpeg \
  --output result.jpg

你也可以在 API playground 中通过可视化界面构建 API 调用，并复制生成的代码。

可以，通过并行发起 API 调用。API 每次调用编辑一张图片，并立即返回结果。要处理产品目录，可以通过工作线程池一次发送多个调用。默认限制为每分钟 60 张图片。Enterprise 套餐可提高此限制，以处理更大的产品目录。

图像编辑 API 属于 Plus API 套餐，每张图片收费 0.10 美元。要免费测试，请使用 沙盒模式：在 API 密钥开头添加 sandbox_。每月最多可免费调用 1,000 次，结果会带有水印。查看 API 定价。

输入：PNG、JPEG 或 WEBP，最大 30 MB，最长边不超过 5,000 px。较大的图片会缩小。输出：默认格式为 PNG，也可选择 JPEG、WEBP 或 AVIF。JPEG 不支持透明效果，因此导出为 JPEG 时请设置背景颜色。请阅读API 文档，了解更多详情。

是的。使用 GET 接口，并将图像的公开 URL 作为 imageUrl 传入。它接受与 POST 接口相同的参数。本地文件使用 POST，已托管在网上的图像使用 GET。

每个响应都包含一个不确定性评分（x-uncertainty-score），范围为 0（确定）到 1（不确定）。你可以用它自动标记需要审核的图像。Enterprise 套餐还提供视觉质检功能，可根据你的质量标准为每个输出评分；你只需为通过检查的图像付费。

可以。在 Claude 的“设置”>“连接器”>“添加自定义连接器”中，使用 Photoroom MCP in Claude 进行连接：https://mcp.photoroom.com/mcp。然后用日常英语提出编辑要求。此功能适用于 Claude、Cowork 和 Claude Code 的付费套餐，使用与 API 相同的积分，每次聊天最多可编辑 20 张图片。

查看API 文档和故障排查页面，或在 API 社区向我们的工程师咨询。有关账单的问题或其他敏感事项，请直接在社区中给 Photoroom 发消息。