Free API — Remove background
Integrate background removal into your website or workflow. Your verified account gets the first 100 successfully processed API images free, without a credit card.
Sign in with a verified email code or Google, then create your key in your account.
Quick start
- Sign in with a verified email code or Google, then create your key in your account.
- Create API key · Key name
- Upload images · JPG, PNG & WebP
The full key is shown only once. Copy it to secure storage and keep it on your server. Never put it in frontend code or a public repository.
curl --fail-with-body \
--request POST \
--header "X-API-Key: YOUR_API_KEY" \
--form "[email protected]" \
"https://background-remover.org/api/v2/remove-background" \
--output result.png Request
https://background-remover.org/api/v2/remove-background| Parameter | HTTP | API documentation |
|---|---|---|
X-API-Key | Header | X-API-Key · Sign in with a verified email code or Google, then create your key in your account. |
file | multipart/form-data | Images up to 20 MB · Single-frame JPG, PNG and WebP images are supported. The safety limit is 24 megapixels for all plans. Convert HEIC, RAW and animated images before uploading. |
Idempotency-Key | Header | Optional: a unique value per source image. A repeated successful or in-progress request returns 409 without another charge. Failed processing may be retried with the same value. |
Responses
Full resolution · PNG · Transparent
Content-Type: image/png
X-API-Quota-Limit: 100
X-API-Quota-Remaining: 99
X-Request-ID: 12345678-1234-1234-1234-123456789abc | HTTP | API documentation |
|---|---|
200 | PNG · No watermark |
400 | file: 1 · multipart/form-data |
401 | Invalid or revoked API key. |
409 | This request is in progress or already completed. |
411 | Content-Length |
413 | 20 MB · 24 MP |
415 | Single-frame JPG, PNG and WebP images are supported. The safety limit is 24 megapixels for all plans. Convert HEIC, RAW and animated images before uploading. |
429 | API allowance exhausted or request rate exceeded. |
503 | The processor is busy. Retry later. |
{"error":"api_quota_exhausted","retryAfter":0}First 100 images free
The allowance is 100 successful API images for the lifetime of your account, shared by all keys. Failed processing does not use it. Creating or rotating keys does not reset it.
API usage is separate from website usage. The website Unlimited subscription does not increase the API allowance. After 100 API images, requests return 429.
Up to 60 accepted API requests per minute per account. For a temporary rate or capacity limit, wait for Retry-After and retry with backoff.
Images are processed temporarily and are not retained for later download. Save the PNG response. The API key authenticates your backend, not a public browser application.
Get a free API key ↗