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, andX-Credits-Chargedresponse 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)
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)
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);
}
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
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.
- Grab 100 Free Credits (no credit card required, instant API key): backgroundremoverapi.com/signup
- 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).
- 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)