Migrating from api.remove.bg/v1.0/removebg to remove.ac

1. Endpoint, authentication and 1-line swap

remove.ac implements the core remove.bg v1.0 HTTP contract across multipart/form-data, application/json, and application/x-www-form-urlencoded bodies. It returns raw image bytes (or a JSON Base64 payload when you send Accept: application/json) together with X-Credits-Charged, X-Width, X-Height, X-Type and X-Foreground-Top/Left/Width/Height headers.

# Before: https://api.remove.bg/v1.0/removebg
# After:  https://remove.ac/v1.0/removebg
curl -f -X POST https://remove.ac/v1.0/removebg \
  -H "X-Api-Key: rac_live_YOUR_API_KEY" \
  -H "Idempotency-Key: order-1042-front" \
  -F "[email protected]" \
  -F "size=auto" \
  -F "format=png" \
  -o shoe-cutout.png

2. Parameter-by-parameter compatibility & differences

3. Handling files over 4.4 MB up to 25 MB / 40 MP

Direct serverless calls to POST /v1.0/removebg cap request bodies at 4.4 MB and response bodies at 4.3 MB. If a lossless PNG cutout exceeds 4.3 MB, the gateway returns HTTP 413 and releases your credit hold before capture (0 credits charged). For high-resolution studio originals up to 25 MB / 40 MP, either pass a public image_url or use single-use HMAC ticket streaming (POST /v1.0/removebg/ticket), which our official Node.js SDK, Python SDK, CLI and MCP server negotiate automatically:

// Node.js 18+ / TypeScript (auto-switches to /v1.0/removebg/ticket above 4 MB)
import { RemoveAcClient } from "remove-ac";
import fs from "node:fs/promises";

const client = new RemoveAcClient({ apiKey: process.env.REMOVE_AC_API_KEY });
const { buffer, creditsCharged, width, height } = await client.removeBackground(
  "./studio-24mp.png",
  { size: "full", format: "png" },
);
await fs.writeFile("studio-24mp-cutout.png", buffer);

# Python (standard requests; or: pip install git+https://github.com/szp2005/remove-ac-sdk.git)
import os, requests

resp = requests.post(
    "https://remove.ac/v1.0/removebg",
    headers={"X-Api-Key": os.environ["REMOVE_AC_API_KEY"]},
    files={"image_file": open("product.jpg", "rb")},
    data={"size": "auto", "crop": "true", "crop_margin": "5%"},
    timeout=60,
)
resp.raise_for_status()
open("product-cutout.png", "wb").write(resp.content)

4. MCP server for AI coding agents & local QA

If your team runs cutouts from Claude Desktop, Cursor, Windsurf or Antigravity, remove-ac ships a zero-dependency stdio MCP server exposing remove_background_file, remove_background_url and get_account_balance:

{
  "mcpServers": {
    "remove-ac": {
      "command": "npx",
      "args": ["-y", "-p", "remove-ac", "remove-ac-mcp"],
      "env": { "REMOVE_AC_API_KEY": "rac_live_YOUR_API_KEY" }
    }
  }
}

Every verified account includes 1 free welcome credit to test the live API sandbox before purchasing credits. For manual edge inspection (including interactive Select subject and the Erase and Restore brush), open the free on-device editor or 50-file batch queue.

Sources

Official provider documents and public datasets referenced in this guide. Provider policies, pricing and endpoints can change; check original pages before deploying.

• remove.ac Developer API & Live Sandbox

  Full /v1.0/removebg parameter contract, status codes, FEFO credit holds and HMAC ticket streaming.

• remove-ac-sdk (Node.js, Python & MCP Server)

  Open-source MIT client libraries, CLI and Model Context Protocol stdio server.

• remove.bg API shutdown notice

  Official notice ending self-service api.remove.bg requests on December 1, 2026.