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:
| Plan | Images / month | Concurrent requests |
|---|---|---|
| Pro | 500 | 5 |
| Business | Unlimited | 50 |
Remove background
Pro & Business
POST
/api/remove-bg
Upload an image and receive a transparent PNG with the background removed.
| Parameter | Type | Required | Description |
|---|---|---|---|
| image_file | File | Yes | The image to process (JPG, PNG, WEBP) |
| size | String | No | Output 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
| Format | Input | Output | Max size |
|---|---|---|---|
| JPEG / JPG | ✓ | — | 10 MB |
| PNG | ✓ | ✓ | 10 MB |
| WEBP | ✓ | — | 10 MB |