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

*Disclosure: I build and maintain [remove.ac](https://remove.ac/?utm_source=hashnode). 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](https://www.remove.bg/faq) and [General Terms and Conditions](https://www.remove.bg/gtc) 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](https://docs.leonardo.ai/docs/migrate-from-the-removebg-api-to-leonardoai):
- **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

```bash
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:

```bash
npm install remove-ac
# or
pip install remove-ac
```

```ts
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](https://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](https://remove.ac/batch?utm_source=hashnode) 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](https://remove.ac/remove-bg-alternative?utm_source=hashnode) · [API migration table](https://remove.ac/guides/remove-bg-api-migration?utm_source=hashnode) · [Pricing](https://remove.ac/pricing?utm_source=hashnode)
