Batch Remove Background
batch_remove_backgroundRemove backgrounds from up to 50 images in a single batch. Supports fast mode for standard size and HD mode for fine details.
Instructions
Remove backgrounds from multiple images in a single batch (up to 50). MANDATORY WORKFLOW — follow these steps in order: (1) Call estimate_credits first (imageCount = number of images). Show user total cost + balance. Ask for confirmation. (2) Only call this tool AFTER the user confirms. (3) After this returns a batchId, poll get_job_status every 5 seconds until all images complete. Credit cost: 1 credit/image (Fast mode, default) or 2 credits/image (HD mode). Fast mode works with any input size — large images are downsampled to 2500px output. Use HD only when user needs output above 2500px, or subjects have fine edge detail (hair, fur, feathers). refineEdges (requires HD): removes color bleeding at edges — recommend for products on colored backgrounds. No extra credit. IMPORTANT about local files: do NOT use base64 — it fills the conversation context. Direct users to share URLs or use https://simplypng.app.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hdMode | No | Fast mode (default, 1 credit/image): input resized to 2500px max — OUTPUT capped at 2500px. Works with any input size. HD mode (2 credits/image): input preserved up to 4096px — OUTPUT up to 4096px. Use HD ONLY when: (1) user explicitly requests HD/high-definition/4K output, (2) user needs output above 2500px, or (3) subjects have fine detail like hair/fur/feathers. Default: false. Never upgrade to HD on your own initiative. | |
| images | Yes | Array of images to process (max 50) | |
| background | No | ||
| outputType | No | Output type for all images | |
| webhookUrl | No | HTTPS URL to receive a POST callback when the batch completes | |
| refineEdges | No | Enable edge color refinement for all images. REQUIRES hdMode: true. No extra credit cost. Recommend when subjects have complex edges against strongly colored backgrounds. | |
| outputFormat | No | ||
| idempotencyKey | No | Optional idempotency key to prevent duplicate batches | |
| backgroundColor | No |