Skip to main content

12 Days Until the remove.bg API Shutdown: A Practical /v1.0/removebg Migration Checklist (Node, Python, n8n, MCP)

Updated 5 min readMarkdown

Disclosure: I build and maintain remove.ac. This guide is an independent engineering checklist based on remove.bg's published FAQ and September 9, 2026 General Terms and Conditions, plus Leonardo.Ai's official Sync API migration docs. remove.ac is not affiliated with or endorsed by remove.bg, Canva, or Leonardo.Ai.

On December 1, 2026 at 09:00 CET (08:00 UTC / 03:00 EST / 16:00 CST), standalone remove.bg, user accounts, and the self-serve /v1.0/removebg API stop accepting requests (Enterprise API contracts continue under existing terms).

Two billing details in remove.bg's FAQ and General Terms and Conditions are easy to miss during a busy sprint:

  • Unused pay-as-you-go (PAYG) credits and monthly rollover credits expire on December 1 with no refund.
  • Account history and invoices become inaccessible after cutoff, so export your billing PDFs and credit CSVs before 09:00 CET.

1. Audit What Actually Breaks on December 1

remove.bg splits its official migration guidance into two destinations:

  1. Website & desktop users → Canva.
  2. Self-service API developers → Leonardo.Ai (cloud.leonardo.ai/api/rest/v2/generationssync).

If you move to Leonardo's Sync API, plan for four contract changes documented in Leonardo's migration guide:

  • Auth: X-Api-Key changes to Authorization: Bearer <token>.
  • Payload: multipart/form-data binary uploads change to JSON-only requests and JSON responses.
  • Retention: Generated outputs are stored in your Leonardo library by default unless you explicitly pass "ephemeral": true on Sync requests.
  • ZIP output: format=zip is not supported.

Before choosing any target provider, inventory:

  • Backend cron jobs, Shopify/WooCommerce webhooks, and ERP product ingestion scripts calling https://api.remove.bg/v1.0/removebg.
  • Low-code automations (n8n, Make, Zapier) and CI pipelines.
  • Desktop or browser bulk workflows used by designers and catalog operators.

2. Option A: Drop-In /v1.0/removebg Swap (Zero Payload Rewrite)

If your main constraint is shipping a reliable cutover before December 1 without rewriting multipart upload logic or OAuth flows, we built POST https://remove.ac/v1.0/removebg to preserve the core /v1.0/removebg contract:

  • Auth: X-Api-Key: rac_live_...
  • Input: multipart/form-data (image_file, image_url, image_file_b64) or application/json
  • Output: Raw PNG/JPG/WebP binary, or Base64 JSON when Accept: application/json is set, plus X-Foreground-* crop metadata headers
  • Stateless memory processing: Zero image bytes persisted to disk or database (only non-image billing metadata such as SHA-256 digests)
  • Error billing: Failed or timed-out requests consume 0 credits
  • Large files past the ~4.4 MB serverless gateway limit: Request a 180-second single-use HMAC ticket from POST /v1.0/removebg/ticket to stream originals up to 25 MB / 50 MP directly into GPU memory without staging files in S3.

Direct curl Check

curl -sS -X POST "https://remove.ac/v1.0/removebg" \
  -H "X-Api-Key: $REMOVE_AC_API_KEY" \
  -F "image_file=@./sample-product.jpg" \
  -F "size=auto" \
  -o cutout.png

Node.js & Python (remove-ac@1.3.0, MIT, Zero Runtime Dependencies)

Install the official client packages from npm or PyPI:

npm install remove-ac
# or
pip install remove-ac
import { RemoveAcClient } from "remove-ac";
import { writeFile } from "node:fs/promises";

const client = new RemoveAcClient({ apiKey: process.env.REMOVE_AC_API_KEY! });
// Automatically uses direct gateway (<= ~4.4 MB) or single-use ticket streaming (up to 25 MB / 50 MP)
const { buffer } = await client.removeBackground("./sample-product.jpg", {
  size: "auto",
  format: "png",
});
await writeFile("./cutout.png", buffer);

Self-Hosted n8n, GitHub Actions & MCP

  • n8n Community Node (v1.0.1): Install n8n-nodes-remove-ac in self-hosted n8n to replace HTTP Request / remove.bg nodes.
  • GitHub Action: szp2005/remove-ac-sdk@v1 for automated asset pipelines.
  • Official MCP Server: io.github.szp2005/remove-ac (npx -y -p remove-ac remove-ac-mcp) for agentic editing workflows.
  • Source code (MIT): github.com/szp2005/remove-ac-sdk

3. Option B: Zero-Upload Browser WASM Studio for Manual Catalog Teams

Not every team needs a paid cloud API. If your operations team cleans up 20–50 product shots manually per session (especially during Black Friday / Q4), remove.ac/batch runs locally in the browser tab at $0 with no login required:

  • First load caches an ONNX Runtime Web (WASM) model (~41 MB on Safari/WebKit 512px tier, ~82 MB on desktop 1024px tier; fresh-device offline use is not guaranteed).
  • Source images stay in tab memory (0 uploads, up to 25 MB / 32 MP single or 50 images per batch ZIP), and a local failure never silently switches to a remote server.
  • Built-in one-pass marketplace presets re-composite with zero re-inference:
    • Amazon Main: 2000×2000 pure white (RGB 255,255,255) at ~`85%` subject fill
    • Shopify: 2048×2048 aligned catalog square
    • Etsy: 2667×2000 / 2000×2000 opaque JPG (prevents Etsy's dark rendering of transparent PNGs)
    • eBay: 1600×1600
  • Single-image editor (/upload) includes interactive Select Subject (<= 25 MP), Erase/Restore brush (12 undo steps), and 300 DPI PNG/JPG/WebP or layered .PSD export.

4. Test Safely Before Spending a Dollar

Whenever you benchmark replacement APIs before December 1, use 15–20 of your hardest real images (flyaway hair, glass bottles, bicycle spokes, high-MP catalog shots) and verify alpha channels, dimensions, error billing, and unit cost.

On remove.ac:

  • Free trial: Verified email signup includes 10 free full-resolution Cloud GPU credits (valid 30 days; size=preview <= 0.25 MP uses 0.25 credit).
  • Dec 1 Tiered Migration Grant (through December 31, 2026): Self-serve checkout auto-applies 30% off Starter (10–75 PAYG, 40 monthly/annual), 40% off Growth (200–500 PAYG/monthly/annual), and 50% off High-Volume (1,200–5,000 PAYG & monthly + 1,200 annual) on your first 3 monthly cycles, first annual year up to 1,200, or non-expiring PAYG packs (up to 3 orders per account, max 1 on 2,800/5,000). Enterprise Annual (2,800 & 5,000 annual) is concierge-verified: email support@remove.ac with a work email or remove.bg invoice for a verified 50% off first-year code.
  • 14-Day Initial-Order Self-Serve Trial Refund: On initial orders within 14 days, 100% refund if 0 credits are used, or 1-click prorated refund from My Account if <= 20% and <= 100 credits are used (minus $1 gateway fee, limit 1 prorated refund per account).

Full migration reference: remove.ac/remove-bg-alternative · API migration table · Pricing

No comments yet. Be the first to comment.