如何在 60 秒内无缝迁移 remove.bg® API
随着独立接口 api.remove.bg 将于 2026 年 12 月 1 日正式停服下线，官方自助 API 用户被引导迁移至 Leonardo.Ai。本文将向您展示如何在不重构任何后端代码的前提下，无缝保留同步直出透明 PNG 的高效流水线。
迁移困境：为什么迁移至 Leonardo.Ai 意味着推倒重构？
当 Canva（remove.bg 母公司）宣布整合 API 服务时，开发者被指示迁移到 Leonardo.Ai。然而，Leonardo 的 API 架构本质上是为耗时的生成式 AI 绘图设计的，而非轻量级同步图像处理：
- • 仅支持异步：返回
job_id，必须编写循环轮询等待。 - • S3 预签名中间跳转：需将图片转为 Base64 JSON 上传，并从临时 AWS S3 存储桶拉取。
- • 代币计费繁琐：单张图片根据分辨率消耗浮动 Token，不可预测。
- • 重构成本极高：需要彻底重写现有的 SDK、异步队列及 Webhook 接收端。
- • 100% 协议兼容：完全相同的
POST /v1.0/removebg路径与入参。 - • 直接返回二进制 PNG：原生 HTTP 数据流直出，无需 S3 中转。
- • 零代码重构：仅需在配置文件中更改 1 行域名 (
baseURL)。 - • 零数据留存：纯内存瞬时处理，HTTP 流传输后彻底销毁。
| 协议维度 | remove.bg® 原生标准 | Leonardo.Ai (官方指引) | BGRemover 平替 API |
|---|---|---|---|
| 目标接口端点 | POST /v1.0/removebg | POST /api/rest/v2/generationssync | POST /v1.0/removebg (完全一致) |
| 鉴权请求头 | X-Api-Key: <KEY> | Authorization: Bearer <KEY> | X-Api-Key: <KEY> (完全一致) |
| 请求编码方式 | multipart/form-data | 仅支持 JSON (application/json) | multipart/form-data (完全一致) |
| 图像上传机制 | 原生二进制文件流 | Base64 字符串或 S3 预签名 URL | 原生二进制文件流 (Identical) |
| 结果响应交付 | 直接返回二进制 PNG 流 (200 OK) | 多层嵌套 JSON 响应对象 | 直接返回二进制 PNG 流 (完全一致) |
| 遥测性能响应头 | X-Width, X-Height, X-Credits | 无任何兼容响应头 | X-Width, X-Height, X-Credits-Charged |
| 开发者重构工作量 | 0（保持现有技术栈） | 推倒重写请求客户端与响应解析器 | 仅需更改 1 行配置：替换域名 |
未用完 remove.bg 额度等额置换保障
官方现购现用（PAYG）额度将于 2026 年 12 月 1 日彻底作废。将您原账户余额截图发送至 [email protected]，即可直接在您的开发者账户中免费获赠等额调用点数（最高可赠 500 点真实生产额度）。
3步极速迁移（耗时约 60 秒）
1. 获取您的平替 API 密钥
在开发者控制台一键生成平替 API Key，或者在本地测试阶段使用沙箱测试 Key。
2. 在系统配置中替换 1 行 Base URL
找到业务系统或环境变量中调用 remove.bg 的客户端配置，将域名直接替换为本站域名：
3. 运行现有的测试用例
直接执行您原有的自动化测试或单元测试。因为所有响应头（X-Width、X-Height、X-Credits-Charged）以及返回的二进制图片流均与原生标准 100% 保持一致，既有断言均可无缝直接通过。
迁移常见问题解答 (FAQ)
我原先在 remove.bg 未用完的额度会怎样？
根据官方停服公告，未使用完毕的额度不会自动顺延至 Leonardo.Ai Token。我们建议您在 2026 年 12 月 1 日前尽快消耗原有额度，同时使用我们的平替端点进行双发灰度对比测试。
入参参数有任何差异或调整吗？
完全没有。标准参数包括 image_file、image_url、size 和 format 均得到原生无缝支持。
准备好迁移您的业务流水线了吗？
立即在交互式实测工作台中上传真实图片，体验毫秒级抠图与响应流。