Developers

API Documentation

Integrate CutPixel background removal directly into your app. Available on Pro and Business plans.

Introduction

The CutPixel API lets you remove backgrounds from images programmatically. Send an image, get back a transparent PNG. Simple REST API, no SDKs required.

Base URL: https://cutpixel.io/api

Authentication

All API requests require your API key passed as a header. Get your key from your account dashboard.

X-Api-Key: your_api_key_here

Rate limits

Rate limits depend on your plan:

PlanImages / monthConcurrent requests
Pro5005
BusinessUnlimited50

Remove background

Pro & Business

POST /api/remove-bg

Upload an image and receive a transparent PNG with the background removed.

ParameterTypeRequiredDescription
image_fileFileYesThe image to process (JPG, PNG, WEBP)
sizeStringNoOutput size: auto (default), preview, full

Response: PNG image with transparent background (Content-Type: image/png)

cURL example

curl -X POST https://cutpixel.io/api/remove-bg \
  -H "X-Api-Key: your_api_key_here" \
  -F "image_file=@photo.jpg" \
  -o result.png

Python example

import requests

with open("photo.jpg", "rb") as f:
    response = requests.post(
        "https://cutpixel.io/api/remove-bg",
        headers={"X-Api-Key": "your_api_key_here"},
        files={"image_file": f}
    )

with open("result.png", "wb") as out:
    out.write(response.content)

print("Done! Saved to result.png")

Node.js example

const fs = require("fs");
const FormData = require("form-data");
const fetch = require("node-fetch");

const form = new FormData();
form.append("image_file", fs.createReadStream("photo.jpg"));

const res = await fetch("https://cutpixel.io/api/remove-bg", {
  method: "POST",
  headers: { "X-Api-Key": "your_api_key_here" },
  body: form
});

const buffer = await res.buffer();
fs.writeFileSync("result.png", buffer);
console.log("Done!");

Supported formats

FormatInputOutputMax size
JPEG / JPG10 MB
PNG10 MB
WEBP10 MB