A familiar HTTP request is a starting point. Use this checklist to test your images and integration before switching production traffic.
1. Check the requests you use
List your input method, output format, size and editing parameters. This service supports file, HTTPS URL and plain base64 input, but does not implement every remove.bg option. Keep API keys on your server and create a new key on an API-enabled plan.
2. Replace the endpoint and key
For supported HTTP requests, retain the request structure and replace the origin and X-API-Key. If a library hard-codes the remove.bg hostname, use its endpoint override when available or call this API directly with an HTTP client. Do not send a remove.bg key to this service.
- POST https://api.remove.bg/v1.0/removebg + POST https://removebgtool.net/v1.0/removebg X-API-Key: YOUR_NEW_API_KEY
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-F 'image_file=@image.jpg' \
-F 'size=auto' \
'https://removebgtool.net/v1.0/removebg' -o no-bg.png3. Map parameters before testing
Compatibility means a supported request shape, not identical segmentation results. In this implementation type must be auto, type_level must be none and channels must be rgba. Nonempty unsupported parameters are rejected rather than silently ignored.
| Request field | Support here |
|---|---|
| image_file / image_url / image_file_b64 | Choose exactly one input: image_file, image_url or image_file_b64. |
| format | auto, png, jpg or webp. ZIP is not supported. |
| size | Pixel ceilings differ by format. Review the size table and output limits. |
| crop / bg_color | crop=true/false and bg_color are supported. |
| type / type_level / channels | Only auto / none / rgba, respectively. |
| bg_image_url / shadow / roi / crop_margin / scale / position | Not supported: background images, shadows, ROI, crop margins, scale or position. |
4. Check responses and billing
Read the response Content-Type before saving the result. The API returns image bytes by default, or JSON with result_b64 when requested. Check X-Credits-Charged and X-Request-ID. Credits belong to this account; remove.bg keys and credit balances cannot be transferred. Preview and full-resolution calls use the same per-image charge here.
5. Run a representative test set
Test normal product and portrait images, low-contrast edges, each output format, oversized files, invalid keys, unsupported parameters and insufficient credits. Verify your handling of 409, 429, timeouts and processing failures. Keep request IDs so you can investigate a failed call.
Optional Idempotency-Key: reuse the same key, image and parameters to replay a successful result for 10 minutes without another charge. A replay repeats the original X-Credits-Charged and adds X-Idempotent-Replayed: true. In-progress requests return 409. Failed or expired keys remain reserved: use a new key to start a new billable request. Without this header, each request is independent. Allow a client timeout of 180 seconds.
6. Switch gradually and keep a fallback
Route a small part of your own workload to the new integration, then review success rate, output quality and credits. Increase traffic only after the results fit your needs. Keep the previous configuration available while validating. Traffic routing and rollback are managed by your application, not by an automatic switch in this service.
Before changing production traffic
remove.bg’s official API page announces a move to Leonardo.Ai starting December 1, 2026. This is not an announcement that RemoveBGTool is the official successor. Keep the website move to Canva separate from your API migration plan.
Source reviewed:
Official remove.bg API announcement| Check in your application | What this implementation expects | Acceptance check |
|---|---|---|
| Input | Exactly one of image_file, image_url or image_file_b64. The developer API accepts up to 22 MiB of image data; the browser uploader has a separate 3 MB limit. | Try one valid input of each type you use. An HTTP response alone does not prove that your source image was the intended one. |
| Defaults and output | The default size is preview (250,000 pixels). Explicitly request the size you need. Formats are auto, png, jpg and webp; ZIP is rejected. | Check Content-Type, actual pixel dimensions and transparency. A larger size ceiling does not guarantee upscaling. |
| Editing options | Only type=auto, type_level=none and channels=rgba are accepted. Nonempty unsupported options such as shadow or bg_image_url return an error. | Remove unsupported settings deliberately; do not assume they have been silently applied. Verify crop and background colour on a sample. |
| Failure and billing | Your integration must handle authentication, credits, conflict, rate-limit and processing errors. Website free previews are not the API billing rule. | Inspect X-Request-ID and X-Credits-Charged on real calls. Follow the API documentation for retry and idempotency handling before increasing traffic. |
These checks are derived from the request parser shipped with this project. They do not certify a deployed endpoint, compatibility with every SDK, identical image quality, latency or available capacity.
This service is independent of remove.bg. Test behavior, not only parameter names.