§ API · DEVELOPER DOCS

DROP-IN REMOVE.BG COMPATIBLE

The drop-in Remove.bg API.

Same endpoints. Same parameters. Same response. 80% cheaper. Webhooks on every plan.

# migration - 1 line changeddrop-in

- curl -X POST https://api.remove.bg/v1.0/removebg \

+ curl -X POST https://api.bgeraser.ink/v1/removebg \

-H 'X-Api-Key: YOUR_KEY' \

-F 'image_file=@./photo.jpg' \

-F 'size=auto'

Get API key - 10 free calls/day Read full docs

No credit card. 10 calls/day free forever.

§ PRINCIPLES

Built for production.

Drop-in Compatible

Every parameter Remove.bg accepts, we accept. Every response field they return, we return. Every error code matches. Change one URL and you're done.

Webhooks On Every Plan

No enterprise gatekeeping. Async processing, delivery retry, signature verification, event subscriptions on every tier.

Production Ready

99.9% uptime SLA. Rate limiting. Usage analytics. Response headers for width, height, credits charged, rate limit remaining.

§ QUICKSTART

Your first call in 30 seconds.

Get an API key from your dashboard, then run:

curl -X POST https://api.bgeraser.ink/v1/removebg \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'image_file=@./photo.jpg' \
  -F 'size=auto' \
  -o result.png

§ PRICING

API plans

Start free with 10 calls per day. Production plans from $29/mo.

PlanVolumeMonthlyAnnual

Free10/day$0--

Business 1K1,000/mo$39$390/yr

Business 3K3,000/mo$99$990/yr

Business 10K10,000/mo$299$2,990/yr

View all plans & pricing Get API key - free

§ AUTHENTICATION

Authentication

All API requests require a valid API key sent via the X-Api-Key header. Keys are created in your API settings.

X-Api-Key: bge_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Remove.bg compatible: We accept the same X-Api-Key header format. No changes needed if migrating.

§ ENDPOINTS

Endpoint reference

POST/v1/removebg

Remove the background from an image. Accepts multipart form data or JSON body. Returns the processed image as binary (PNG, JPEG, or WebP).

Request formats

curl -X POST https://api.bgeraser.ink/v1/removebg \
  -H 'X-Api-Key: YOUR_KEY' \
  -F '[email protected]' \
  -F 'size=auto' \
  -F 'type=auto' \
  -F 'format=png'

§ PARAMETERS

Parameters

NameTypeRequiredDescription

image_fileFileone requiredImage file (multipart). JPG, PNG, or WebP.

image_urlstringone requiredURL of the image to process.

image_file_b64stringone requiredBase64-encoded image data.

sizestringoptional"auto" (default), "preview" (1024px), "full" (2048px).

typestringoptional"auto" (default), "person", "product", "car". Controls model variant.

formatstringoptional"png" (default), "jpg", "webp". Output format.

bg_colorstringoptionalHex color for background (e.g., "#FF0000"). Only with jpg format.

Response headers

X-Image-WidthWidth of the output image in pixels

X-Image-HeightHeight of the output image in pixels

X-Credits-ChargedNumber of credits charged (always 1)

X-RateLimit-LimitRate limit ceiling for this window

X-RateLimit-RemainingRemaining calls in this window

X-RateLimit-ResetUnix timestamp when the window resets

§ ERRORS

Error codes

All errors return JSON with an errors array. HTTP status codes match Remove.bg conventions.

400Missing required parameter

{ "errors": [{ "title": "Missing image_file", "code": "missing_parameter" }] }

401Invalid or missing API key

{ "errors": [{ "title": "Invalid API key", "code": "authentication_error" }] }

402Monthly quota exceeded

{ "errors": [{ "title": "Rate limit exceeded", "code": "quota_exceeded" }] }

429Too many requests per minute

{ "errors": [{ "title": "Rate limit exceeded", "code": "rate_limited" }] }

500Internal processing error

{ "errors": [{ "title": "Internal processing error", "code": "internal_error" }] }

§ MIGRATE

Migrate from Remove.bg in 30 seconds.

Change one URL. That's it. Every parameter, header, and response format is identical.

Change the endpoint URL

- https://api.remove.bg/v1.0/removebg
+ https://api.bgeraser.ink/v1/removebg

That's it. Here's proof:

# Remove.bg (before)
curl -X POST https://api.remove.bg/v1.0/removebg \
  -H 'X-Api-Key: YOUR_REMOVEBG_KEY' \
  -F '[email protected]' -o result.png

# bgeraser.ink (after) - same command, new URL
curl -X POST https://api.bgeraser.ink/v1/removebg \
  -H 'X-Api-Key: YOUR_BGERASER_KEY' \
  -F '[email protected]' -o result.png

§ INTERACTIVE

Try it live.

Paste your API key, drop an image, and run a real request.

curl -X POST https://api.bgeraser.ink/v1/removebg \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'image_file=@./photo.jpg' \
  -F 'size=auto' \
  -F 'type=auto' \
  -F 'format=png' \
  -o result.png

Select an image to get started

Response time: --Credits: --

§ PERFORMANCE

Typical response times

bgeraser uses state-of-the-art segmentation models on GPU infrastructure for pixel-precise cutouts. Output quality is consistent regardless of plan tier.

After your first request, subsequent requests within 5 minutes are served from a warm endpoint with significantly lower latency.

Image sizeCold requestWarm request

< 2 MP2-4s0.8-1.5s

2-8 MP4-7s1.5-3s

8-16 MP7-12s3-6s

16+ MP12-20s6-10s

Tips for fastest response

•Resize images to 2048px on the longest side before upload (no quality loss for most use cases)
•Reuse the same API key across requests to keep your endpoint warm
•For high volume, contact us for dedicated infrastructure pricing

§ RATE LIMITS

Rate limits

Rate limits are applied per API key. Response headers include X-RateLimit-* fields on every response.

PlanRate limitMonthly quotaPrice

Free10/min10/day$0

Business 1K100/min1,000/mo$39/mo

Business 3K100/min3,000/mo$99/mo

Business 10K200/min10,000/mo$299/mo

§ NUMBERS

Numbers we publish.

99.9%

uptime SLA

p95 < 2s

4MP images

500/min

max rate limit

Get your first API key in 30 seconds.

10 free calls per day. No credit card. Forever.