remove.bg 的 API 即将停止服务。改一行代码，其余不变。
remove.bg 的独立网站和自助 API 将于 停止服务。API 将迁移到 Leonardo.Ai（Canva 旗下公司），届时需要修改你的集成（Leonardo.Ai 的公告）。removebackground.dev 接受相同的请求：把代码指向我们的 URL，换用我们的密钥，就完成了。
remove.bg 的自助 API 将于 停止服务
唯一需要修改的一行
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebg同样使用 X-Api-Key 请求头，只是换成你的 removebackground.dev 密钥。相同的参数名、相同的响应头、相同的 {"errors": [...]} 错误格式。
修改前后对比
四种语言的典型集成示例。密钥从 REMOVEBG_API_KEY 读取，因此唯一需要修改的就是高亮的 URL。
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
在用 Zapier、Make 或 n8n？
打开调用 remove.bg 的 HTTP 请求步骤（Zapier Webhooks、Make HTTP、n8n HTTP Request），将 URL 改为 https://removebackground.dev/v1.0/removebg，并将 X-Api-Key 的值改为你的 removebackground.dev 密钥。其他字段保持不变。
参数兼容性
你的 remove.bg 请求发送的所有内容都会被接受。少数选项在这里不起作用，下表中已注明。
| 参数 | 状态 | 说明 |
|---|---|---|
image_file / image_file_b64 / image_url | 支持 | 支持 multipart、urlencoded 或 JSON 请求体。JPG、PNG 或 WebP，最大 25 MB。 |
size | 支持 | auto、full、4k 和 50MP 返回原始分辨率（最高 25 MP）；preview、small 和 regular 约 0.25 MP；medium 1.5 MP；hd 4 MP。始终消耗 1 点数。 |
format | 支持 | auto（有透明区域时为 PNG，否则为 JPG）、png、jpg、webp 和 zip（color.jpg + alpha.png）。 |
crop / crop_margin | 支持 | 以 px 或主体的 % 表示，1–4 个 CSS 风格的值（"10% 20%" = 垂直、水平）；每边最多 500px 或 50%。 |
roi | 支持 | "x1 y1 x2 y2"，单位为 px 或 %：仅保留区域内的主体。 |
scale / position | 支持 | scale 为 10%–100% 或 original；position 为 center、original 或 "x% y%"。 |
channels | 支持 | rgba（抠图）或 alpha（灰度蒙版）。 |
bg_color | 支持 | 十六进制颜色，带或不带 #（81d4fa），或颜色名称。8 位十六进制值会保留颜色并丢弃其 alpha。 |
bg_image_url / bg_image_file | 支持 | 抠图会叠加在你的背景图片上，背景图片以 cover 方式适配输出尺寸。 |
Accept: application/json | 支持 | 返回 { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }。 |
type / type_level | 接受但忽略 | 主体会被自动识别；X-Type 始终为 "other"。 |
semitransparency | 接受但忽略 | 柔和边缘和半透明区域直接来自模型生成的蒙版。 |
shadow_type / shadow_opacity / add_shadow | 接受但忽略 | 不添加阴影。 |
长时间运行的请求 | 有差异 | 我们最多等待 110 秒；如果届时图片仍未就绪，你会收到可重试的 503（除非处理完成，否则不扣费）。 |
响应头
调用成功时返回图片字节（image/png、image/jpeg、image/webp 或 application/zip）以及以下响应头。发送 Accept: application/json 则改为返回 result_b64。
| 响应头 | 含义 |
|---|---|
X-Width / X-Height | 结果的尺寸（像素）。 |
X-Credits-Charged | 该图片消耗的点数：始终为 1（失败的图片为 0）。 |
X-Type | 始终为 "other"（主体自动识别）。 |
X-Foreground-Top / -Left / -Width / -Height | 结果中主体的边界框，单位为像素。 |
X-Request-ID | 回传你的 X-Request-ID，或一个生成的 id。额外提供。 |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | 蒙版的干净程度（0–1），以及柔和像素的占比。额外提供：可用于标记需要人工检查的图片。 |
错误
| 状态码 | 含义 |
|---|---|
400 | 参数或图片无效（错误码如 invalid_size、invalid_crop_margin、missing_source、file_too_large、unknown_foreground）。 |
402 | insufficient_credits：请在价格页面充值。 |
403 | auth_failed：X-Api-Key 缺失或无效。 |
429 | rate_limit_exceeded。 |
500 / 503 | 处理失败、超时或服务暂时不可用。请重试；失败的图片免费。 |
使用 GET https://removebackground.dev/v1.0/account 查询余额：响应采用 remove.bg 的账户格式。完整说明见 API 参考。
点数：每张图片 1 点数，永不过期
每张成功的图片消耗 1 点数，无论尺寸或选项如何。失败的图片免费。 新账户赠送 50 免费点数用于测试。
- 点数永不过期一次充值，下周或明年再用都行。
- 无需订阅一次性点数包，不会自动续费。
- 失败的图片免费只有成功去除背景才消耗点数。
迁移清单
- 获取 removebackground.dev API 密钥注册（赠送 50 免费点数），然后在账户页面创建密钥。
- 修改一行代码将代码指向 https://removebackground.dev/v1.0/removebg，并把新密钥放在同一个 X-Api-Key 请求头中。
- 测试一张图片发送一个真实请求，并将输出与你目前得到的结果进行比较。
- 切换流量在 2026年12月1日 09:00 CET 前部署。一次充值点数，永不过期。
remove.bg 迁移常见问题
remove.bg 要停止服务了吗？
remove.bg 的独立网站和自助 API 将于 2026年12月1日 09:00 CET 停止服务。API 将迁移到 Leonardo.Ai（Canva 旗下公司），届时需要修改你的集成。来源：Leonardo.Ai 的公告 https://www.leonardo.ai/news/removebg-api-leonardo。
最简单的 remove.bg API 替代方案是什么？
removebackground.dev 提供兼容 remove.bg 的端点。将 https://api.remove.bg/v1.0/removebg 改为 https://removebackground.dev/v1.0/removebg，在同一个 X-Api-Key 请求头中发送 removebackground.dev 密钥，其余代码保持不变：参数名、响应头和错误格式都一致。
我需要在 2026 年 12 月前重写集成吗？
不需要。请求使用相同的参数（image_file、image_url、size、format、crop、bg_color…），并获得同类响应：带 X-Width、X-Height 和 X-Foreground-* 响应头的图片字节，或包含 result_b64 的 JSON。只有 URL 和密钥需要更改。
支持 Zapier、Make 或 n8n 吗？
支持。在你的 HTTP 请求步骤（Zapier Webhooks、Make HTTP、n8n HTTP Request）中，将 URL 改为 https://removebackground.dev/v1.0/removebg，并将 X-Api-Key 的值改为你的 removebackground.dev 密钥。其他都不用改。
费用是多少？
每张成功的图片 1 点数，无论尺寸或选项如何。无需订阅：一次性充值 US$17、US$49 或 US$99，点数永不过期。失败的图片免费。新账户赠送 50 免费点数。
支持哪些 remove.bg 参数？
image_file、image_file_b64、image_url、size、format（auto、png、jpg、webp、zip）、crop、crop_margin、roi、scale、position、channels、bg_color、bg_image_url 和 bg_image_file。type、type_level、semitransparency 及阴影相关选项会被接受但忽略，因此发送这些参数的请求依然可以正常工作。
还能像以前一样查询余额吗？
可以。使用你的密钥调用 GET https://removebackground.dev/v1.0/account，会以 remove.bg 的账户格式返回你的点数。
removebackground.dev 与 remove.bg 有关联吗？
没有。remove.bg 是其所有者的商标。removebackground.dev 是一个独立服务，接受相同的 API 请求。
在 2026年12月1日 09:00 CET 前完成切换
remove.bg 的自助 API 将于 停止服务
创建密钥，修改一行代码，测试一张图片。 赠送 50 免费点数。
remove.bg 是其所有者的商标；removebackground.dev 与其没有关联。