2026 年 12 月 1 日前从 remove.bg API 迁移实战指南:检查清单、成本对比与代码示例
针对 remove.bg 官方 API 于 2026 年 12 月 1 日转向 Leonardo.Ai 的时间节点,提供端点切换、参数兼容核对、套餐成本对比与 cURL/Node.js 迁移代码示例。
为什么建议在 2026 年 12 月 1 日前完成切换测试?
根据 remove.bg 官方公开公告,其网页端功能逐步并入 Canva,而独立 API 计划于 2026 年 12 月 1 日转向 Leonardo.Ai(官方定价页同时列出积分到期时间为 2026 年 12 月 1 日 9:00 AM CET)。如果你的电商系统、SaaS 应用或自动化脚本目前直接调用 https://api.remove.bg/v1.0/removebg,提前在测试环境完成替换验证,可以避免截止日前后出现线上中断或计费异常。
RemoveBGTool(https://removebgtool.net)是独立运营的图片去背景平台与开发者 API,与 remove.bg、Canva、Leonardo.Ai 均无从属关系。下文整理了迁移前必须核对的价格对比、参数兼容边界与最小改造代码。
价格与核心规格对比(2026-11-21 核对)
| 对比维度 | remove.bg(公开快照) | RemoveBGTool(removebgtool.net) |
| -------------------- | ------------------------------------------ | ------------------------------------------------------------- |
| API 端点 | POST https://api.remove.bg/v1.0/removebg | POST https://removebgtool.net/v1.0/removebg |
| 鉴权头 | X-API-Key | X-API-Key |
| 入门月订阅 | $9 / 月(40 积分) | $8.10 / 月(40 积分) |
| 中高用量月订阅 | 阶梯月付 | $35.10 / 月(200 积分)、$80.10 / 月(500 积分) |
| 按需一次性积分包 | $3 / 3 积分 | $2.70 / 3 积分、$8.10 / 10 积分、$44.10 / 75 积分 |
| 积分通用性 | 账户余额 | 网页完整尺寸、批量 ZIP 导出与 API 共用同一积分余额 |
| API 单图上限 | 最高 22 MB | 最高 22 MiB(支持文件、HTTPS URL、base64) |
| 免费网页试用 | 预览图 | 游客 3 张/天、登录 5 张/天无水印 0.25 MP 预览图 |
第三方最新条款请直接以 remove.bg 官方定价页 与 remove.bg 官方 API 页 为准。旧平台的账户、密钥和剩余积分无法迁入 RemoveBGTool。
第一步:盘点现有代码实际发送的请求参数
在修改任何生产配置前,先记录当前线上真实传递的字段。RemoveBGTool 保持了 POST /v1.0/removebg + X-API-Key 的基础调用习惯,同时清晰区分已支持参数与未覆盖的排版类参数:
| 参数字段 | RemoveBGTool API 支持情况 | 迁移说明 |
| -------------------------------------------------------- | ------------------------- | ---------------------------------------------------------------------- |
| image_file / image_url / image_file_b64 | 支持 | 每次请求传一种输入,上限 22 MiB。 |
| size | 支持 | 默认 preview,按业务需要传入完整处理尺寸并在测试环境校验实际像素。 |
| format | 支持 | 支持透明 PNG、JPG、WebP(API 不直接返回 ZIP,批量 ZIP 请使用网页端)。 |
| bg_color / crop | 按文档核对 | 接入前请查阅 API 文档 与 OpenAPI 规范。 |
| shadow / roi / scale / position / bg_image_url | 非完全原样兼容 | 建议先获取透明 PNG,再在自有图像处理管线中完成阴影和构图合成。 |
第二步:替换端点与 API Key(cURL 与 Node.js 示例)
在账户设置页生成 RemoveBGTool API Key 后,建议先用 10–20 张真实业务图片(浅色商品、复杂发丝、反光物体、深色背景)进行灰度验证。
cURL 调用示例
curl -X POST "https://removebgtool.net/v1.0/removebg" \
-H "X-API-Key: YOUR_REMOVEBGTOOL_API_KEY" \
-F "image_file=@product.jpg" \
-F "size=full" \
-F "format=png" \
-o product-cutout.png
Node.js / TypeScript 调用示例
import { readFile, writeFile } from 'node:fs/promises';
const form = new FormData();
const bytes = await readFile('product.jpg');
form.append(
'image_file',
new Blob([bytes], { type: 'image/jpeg' }),
'product.jpg'
);
form.append('size', 'full');
form.append('format', 'png');
const res = await fetch('https://removebgtool.net/v1.0/removebg', {
method: 'POST',
headers: { 'X-API-Key': process.env.REMOVEBGTOOL_API_KEY! },
body: form,
});
if (!res.ok) {
const err = await res.text();
throw new Error(`RemoveBGTool API error ${res.status}: ${err}`);
}
const buffer = Buffer.from(await res.arrayBuffer());
await writeFile('product-cutout.png', buffer);
第三步:上线前 3 项必查验收
- 抽检高难图边缘:重点检查白底上的浅色包装、卷发/低对比度人像发际线、玻璃/金属反光以及包袋提手内部镂空。
- 规范错误码与重试:针对
401(鉴权失败)、402(insufficient_credits积分不足)、413(超体积)不盲目重试,仅对临时5xx做有限次退避重试,避免重复扣费。 - 核对计费与并发:确认失败请求不会扣减积分,并对照月处理量选择月订阅或一次性积分包。
下一步入口
- 查看完整 remove.bg API 迁移清单 与 API 参考文档。
- 如果是网页端人工抠图用户,可直接使用 remove.bg 替代工具、批量去背景工具 或查看 remove.bg 价格对比。