DEV Community

a353551071
a353551071

Posted on

13 Days Until remove.bg Shuts Down: The 60-Second Drop-In API Migration Runbook

On December 1, 2026, at 9:00 AM CET, Canva is permanently sunsetting the standalone remove.bg website and its self-serve API.

If your production service relies on api.remove.bg/v1.0/removebg, any requests sent after that morning will return connection failures or 404s. Unused prepaid credits will simply expire.

The official recommendation from Canva is to migrate to Leonardo.Ai.

While Leonardo is great for generative diffusion art, it is NOT a drop-in background removal replacement. Migrating to Leonardo forces you to rewrite a synchronous image-in -> png-out pipeline into a multi-step asynchronous workflow (submit job -> get job_id -> polling loop -> presigned S3 fetching).

If you don't have the engineering bandwidth to rewrite and re-test your production background removal service before December 1st, here is a complete, field-tested drop-in runbook that takes 60 seconds and zero code changes.


The Core Problem: Why Leonardo.Ai Is a Rewrite, Not a Swap

Let’s look at the architectural reality of what Canva is asking you to do:

Feature remove.bg (Current) Leonardo.Ai (Official Path) Drop-in API (This Runbook)
Architecture Synchronous (1 request) Asynchronous Job Queue Synchronous (1 request)
Payload multipart/form-data JSON / Presigned S3 URLs multipart/form-data
Response Binary image/png stream JSON with image URLs Binary image/png stream
Code Changes 0 Full client & webhook rewrite 1 line (change baseURL)
Pricing Predictable credit/image Variable token costs $0.02 - $0.04 / image

If you have a backend worker that simply expects raw PNG bytes in response to a POST request, adopting Leonardo means writing queue workers and handling async state machines.


The 60-Second Fix: Drop-In Replacement

To eliminate this friction, we built Background Remover API as a strict, protocol-compatible clone of the POST /v1.0/removebg endpoint.

All core parameters are 100% matched:

  • image_file (multipart file upload)
  • image_file_b64 (Base64 encoded string)
  • image_url (public HTTPS URL)
  • Header X-Api-Key
  • Binary PNG stream output with identical X-Width, X-Height, and X-Credits-Charged response headers.

1. Python Migration (requests)

Before (remove.bg):

import requests

response = requests.post(
    "https://api.remove.bg/v1.0/removebg",
    files={"image_file": open("product.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": "YOUR_REMOVEBG_KEY"},
)
with open("no-bg.png", "wb") as out:
    out.write(response.content)
Enter fullscreen mode Exit fullscreen mode

After (1-line change):

import requests

response = requests.post(
    # Only change the hostname:
    "https://api.backgroundremoverapi.com/v1.0/removebg",
    files={"image_file": open("product.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": "YOUR_NEW_API_KEY"},
)
with open("no-bg.png", "wb") as out:
    out.write(response.content)
Enter fullscreen mode Exit fullscreen mode

2. Node.js / TypeScript Migration (fetch / FormData)

import fs from "fs";

const form = new FormData();
form.append("image_file", new Blob([fs.readFileSync("photo.jpg")]));

const res = await fetch("https://api.backgroundremoverapi.com/v1.0/removebg", {
  method: "POST",
  headers: {
    "X-Api-Key": process.env.BG_REMOVER_KEY!,
  },
  body: form,
});

if (res.ok) {
  const buffer = Buffer.from(await res.arrayBuffer());
  fs.writeFileSync("output.png", buffer);
}
Enter fullscreen mode Exit fullscreen mode

3. cURL (Instant CLI Test)

You don't even need to create an account to test this right now. We provide an instant sandbox key for terminal testing:

curl -H "X-Api-Key: test_sandbox_key_2026" \
     -F "image_file=@your-image.jpg" \
     -o output.png \
     https://api.backgroundremoverapi.com/v1.0/removebg
Enter fullscreen mode Exit fullscreen mode

Parameter Compatibility Audit

To keep things completely transparent, here is what is supported and what is ignored:

Parameter Support Status Notes
image_file ✅ FULL SUPPORT Direct multipart file upload
image_file_b64 ✅ FULL SUPPORT Raw base64 or data URI
image_url ✅ FULL SUPPORT Public HTTP/HTTPS images up to 30MB
size ⚠️ Accepted Always returns full HD output
format ⚠️ Accepted Always returns 32-bit RGBA PNG
crop / bg_color ❌ Ignored Keep composite logic client-side
GET /v1.0/account ✅ FULL SUPPORT Returns credits quota JSON

Free Tier & Getting Started

With the December 1st shutdown less than two weeks away, don't let broken pipelines surprise you on Monday morning.

  1. Grab 100 Free Credits (no credit card required, instant API key): backgroundremoverapi.com/signup
  2. Need to process images in bulk without code? Check out our browser-based Bulk Background Remover (processes up to 10 photos simultaneously with one-click ZIP download).
  3. Need developer documentation? Full guides available at backgroundremoverapi.com/api-docs.

If you have custom enterprise volume requirements or questions on error taxonomy mapping, feel free to drop a comment below!

Top comments (0)