Background Removal API

Quickstart

Get started in 30 seconds. No credit card required.

1. Get your API key

Sign up at cleanbg.pages.dev, then go to your dashboard to generate an API key. Or use the API:

2. Remove a background

Send a POST request with your image (base64 JSON or raw binary):

curl -X POST https://cleanbg-api.sundeen10.workers.dev/api/v1/remove-bg \
  -H "X-API-Key: cbg_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"image": "BASE64_IMAGE_DATA"}'

Or send raw binary:

curl -X POST https://cleanbg-api.sundeen10.workers.dev/api/v1/remove-bg \
  -H "X-API-Key: cbg_your_api_key_here" \
  -H "Content-Type: image/png" \
  --data-binary @photo.png

JavaScript Example

// Node.js / Browser
var response = await fetch("https://cleanbg-api.sundeen10.workers.dev/api/v1/remove-bg", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "cbg_your_api_key_here"
  },
  body: JSON.stringify({
    image: base64ImageData,  // base64-encoded image
    type: "image/jpeg"       // optional: image/jpeg, image/png, image/webp
  })
});

var data = await response.json();
// data.image = base64-encoded PNG with transparent background
// data.usage = { used: 5, limit: 50, remaining: 45 }

Python Example

import requests, base64

with open("photo.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

resp = requests.post(
    "https://cleanbg-api.sundeen10.workers.dev/api/v1/remove-bg",
    headers={"X-API-Key": "cbg_your_api_key_here"},
    json={"image": image_b64, "type": "image/jpeg"}
)

result = resp.json()
with open("result.png", "wb") as f:
    f.write(base64.b64decode(result["image"]))

API Reference

Remove the background from an image. Returns a PNG with transparent background.

Headers

JSON Body

{
  "image": "iVBORw0KGgo...",        // base64 PNG with transparent bg
  "format": "image/png",
  "usage": {
    "used": 6,
    "limit": 50,
    "remaining": 44
  }
}

Check your current usage and remaining quota.

{
  "tier": "free",
  "tier_name": "Free",
  "monthly_limit": 50,
  "monthly_used": 12,
  "monthly_remaining": 38,
  "period": "2026-03"
}

API Pricing

Start free. Scale as you grow. All plans include the same AI quality.

vs. remove.bg API Pricing

Embed Widget

Add background removal to your website with one line of code. Your users upload images, CleanBG processes them.

<iframe
  src="https://cleanbg.pages.dev?embed=true&key=cbg_your_api_key"
  width="100%" height="500"
  style="border:none;border-radius:12px"
></iframe>

The widget uses your API key and counts against your monthly quota. Style it with CSS to match your site.

Support

Questions? Email support@fliplistai.com or open an issue on GitHub.