什么是背景移除 API？
ImgGen AI 背景移除 API 是一个 REST 端点，它把照片中的前景主体与背景分离，并返回一张透明 PNG。您通过 HTTPS 上传图像，AI 自动识别主体，抠好的结果以 base64 编码在 JSON 响应中返回。无需蒙版，也无需手动选区。
这是 ImgGen AI 图像编辑 API 七个端点之一，它们共用同一个 API 密钥、同一个基础 URL，以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能，同一套 AI 模型也驱动着 Background Remover 工具。
请求参数
向 https://app.imggen.ai/v1/remove-background 发送一个 POST 请求，并在 Authorization 请求头中使用 API 密钥进行认证。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| image | file | 必填 | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
如何集成背景移除 API？
在您的 ImgGen 账户中创建一个 API 密钥，将其设为环境变量，然后调用该端点。以下是同一个请求的 cURL、Node.js 与 Python 写法。
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))响应
成功的调用会返回 JSON。结果为 base64 编码——写入磁盘或对象存储前请先解码。每次成功的响应还会带上 X-Credit-Remaining 请求头，显示本次调用后的余额。
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}值得了解的限制与行为
该端点接受 JPEG（JPG）、PNG 和 WebP，文件最大 25 MB，并在 60 秒内同步返回结果——无需轮询任务，也无需配置 webhook。
透明 PNG 输出
结果带有真正的 alpha 通道，因此您可以把它合成到任何背景、颜色或模板上，无需再发一次请求。
无需蒙版
主体识别是自动的——前景会替您从背景中分离出来。没有什么需要涂抹、勾勒或作为第二个参数传入：发送输入图像，读取结果即可。
不存储任何内容
输入只在调用期间保存在一个临时对象中，之后即被删除。当您处理的是不被允许留存的客户照片时，这一点很实用。
背景移除 API 用在哪些场景？
各团队将此端点用于生产环境，以编程方式大规模处理图像的场景。
电商商品目录
在上传时就抠掉供应商商品图的背景，让每个商品页都呈现干净一致的抠图效果，无需任何人工编辑环节。
电商平台与分类信息
自动统一卖家上传的照片。让每次上传都经过该端点，并把透明 PNG 与原图一并保存。
按需印刷
在合成到样机之前先把图案和主体抠出来，让预览图在任何产品尺寸下都能正确渲染。
设计与编辑类 SaaS
在您自己的产品中为用户提供一键背景移除，无需训练模型、托管模型，也无需在 AWS 或其他任何地方运行自己的推理服务。
背景移除 API 的费用是多少？
每次成功调用消耗 1 积分，因此单张图片的实际成本取决于您所用的套餐。积分来自您的套餐，并在所有端点与网页编辑器之间共用，您无需为每个工具单独购买配额。调用失败会自动退还。完整细节见价格页面。
| 套餐 | 价格 | 积分 | API |
|---|---|---|---|
| Free | $0 | 50 个一次性免费积分 | 不含 API 访问 |
| Starter | $9.99 / month | 每月 400 积分 | 含 API 访问 |
| Pro | $29.99 / month | 每月 1,400 积分 | API 访问 + 优先支持 |
| Enterprise | Custom | 定制用量 | 专属基础设施 |
积分费用与限制最近核实于 2026-08-27.
相关端点与工具
使用背景移除 API 的团队，接下来通常还会用到这些。
背景移除 API 常见问题
- 它是一个 HTTP 端点，接收一张照片，返回同一张照片——背景已被移除，主体保留在透明图层上。因为它是 API 而不是编辑器，您可以从后端任务、队列 worker 或用户上传处理器中调用它，在无人打开浏览器的情况下处理成千上万张图片。
- 在 ImgGen 账户中创建一个 API 密钥，然后向 https://app.imggen.ai/v1/remove-background POST 一个包含 image 字段的 multipart 表单，并带上 Authorization: Bearer 请求头。响应为 JSON；把 base64 的 image 字段解码后写入磁盘或对象存储即可。本页提供了可直接运行的 cURL、Node.js 与 Python 示例。
- 每次成功调用 1 积分——这是本 API 中最便宜的端点。Starter 每月 400 积分、9.99 美元，大约相当于 400 次背景移除；Pro 每月 1,400 积分、29.99 美元。订阅期内未使用的积分可滚存，调用失败会自动退还，因此只有真正返回结果的图片才会计费。
- 您可以创建账户，用 50 个免费积分试用这些 AI 工具，无需信用卡。API 访问包含在 Starter 与 Pro 付费套餐中；并不存在长期免费的 API 层级，与其宣传一个之后悄悄限速的版本，我们更愿意直说。
- 该 API 接受 JPEG（JPG）、PNG 和 WebP 文件，每张图片最大 25 MB。结果以 base64 编码的图像形式在 JSON 响应中返回。
- 不会。该 API 是无状态的：它不会创建项目、不会保存文件，也不会保留您的图像。您上传的文件会写入一个临时对象，处理完成后在响应返回的同时立即删除。唯一保留的是一条使用日志，记录发生过一次调用以及消耗了多少积分。您的图像绝不会用于训练模型。
- 可以。包括免费套餐在内的所有套餐都包含完整的商业使用权，且任何输出都不带水印。API 返回的任何内容，您都可以出售、打印或发布。
- 该端点返回的是透明 PNG，因此合成新的颜色、渐变或背景板是在您自己的流程里完成的，无需再调用一次 API。如果您想要 AI 生成的背景而不是自有素材，ImgGen 网页编辑器里还有一个背景生成器。