Photoroom API 集成入门 —— 一小时开始自动化
Photoroom API 是什么
Photoroom 提供 REST API（image-api.photoroom.com），允许开发者在自己的系统中调用 Photoroom 的全部 AI 图片处理能力：
- 背景移除
- AI 背景生成
- AI 改色
- Ghost Mannequin
- Virtual Model
- Ironing
- AI 阴影
- 批量处理
API 文档地址：docs.photoroom.com
谁需要 API
- 电商平台 / SaaS 工具需要集成 AI 图片处理能力
- 企业 PIM/DAM 系统需要自动化产品图处理管线
- 开发者需要在自己的应用中加入 Photoroom 能力
- 高频大批量处理（1000+ 张/天）的场景
API 接入步骤
Step 1：获取 API Key
Photoroom API 的接入路径因订阅不同：
- 沙盒测试：Web 版账户后台有 Playground，可以生成测试用 API Key（有限额度，用于开发调试）
- 正式环境：Ultra / Enterprise 合同包含正式 API Key，联系 Photoroom 销售获取
Step 2：了解基础接口
Photoroom Edit API 的基础端点：
POST https://image-api.photoroom.com/edit/v1/image
Content-Type: multipart/form-data
x-api-key: <你的API密钥>上传一张图片（multipart form）+ JSON 配置（描述要做哪些 AI 操作）→ 返回处理后的图片。
Step 3：配置预设（Preset）
Photoroom API 支持预设配置——你可以在 Playground 里配置好一套 AI 操作序列（比如：先抠图 → 换白底 → 加阴影 → 裁成 Amazon 主图规格），保存成 Preset。之后 API 调用时直接引用 Preset ID，不需要每次传完整配置。
这是 Photoroom API 相比竞品的一个优势——不用在 API 里传复杂的参数组合，预设在 Playground 里一次配好，代码里只传 Preset ID。
Step 4：开始编码
Photoroom API 返回处理后的图片 URL（或 base64，可选），你保存到自己的存储系统即可。
价格与计费
Photoroom API 的计费模式：
| 套餐 | 价格 | 典型配额 |
|---|---|---|
| Sandbox | 免费 | 开发测试用，限额 |
| Enterprise / Ultra | 定制 | 按图片数量/月，SLA 保障 |
API 调用的价格根据功能不同而不同——基础抠图最便宜，虚拟模特、视频生成等复杂功能更贵。
和竞品 API 的对比
| 对比项 | Photoroom API | Remove.bg API | Adobe API |
|---|---|---|---|
| 核心能力 | 产品图全套处理 | 纯抠图 | 全套修图 |
| 服装特化 | ✅ 隐形人台、虚拟模特 | ❌ | ❌ |
| 预设配置 | ✅ Playground 可视化 | ❌ 纯参数 | ✅ |
| 成本 | 中 | 低 | 高 |
| 目标用户 | 电商产品目录 | 通用抠图需求 | 设计师工作流 |
实际集成案例
Photoroom 公开的 API 集成案例包括：
- Shopify App 自动处理新上架产品图
- 电商 PIM 系统自动处理目录图片管线
- SaaS 设计工具集成 AI 图片处理
- 跨境电商 ERP 自动生成多平台规格图片
开发提示
图片上传格式限制
- 支持 JPG、PNG
- 建议分辨率 ≤ 2500 万像素（约 5000x5000）
- 文件过大时建议在客户端先压缩
响应时间
- 简单抠图：1-3 秒
- 复杂 AI 功能（虚拟模特等）：5-30 秒
错误处理
API 返回标准 HTTP 状态码 + 错误详情 JSON。常见错误包括：
- 401：API Key 无效或过期
- 413：图片太大
- 429：调用频率超限
- 500：Photoroom AI 服务异常