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.
This service is independent of remove.bg. Test behavior, not only parameter names.