Remove Background
remove_backgroundRemove background from image URLs. Choose fast mode for standard images or HD mode for fine edge detail and high resolution.
Instructions
Remove the background from a single image. MANDATORY WORKFLOW — follow these steps in order: (1) Call estimate_credits first (imageCount=1). Show user the cost + balance. Ask for confirmation. (2) Only call this tool AFTER the user confirms. (3) After this returns a jobId, poll get_job_status every 3 seconds until status is "succeeded". (4) Call download_results to get the final download URL. Credit cost: 1 credit (Fast mode, default) or 2 credits (HD mode). Fast mode works with any input size — large images are just downsampled to 2500px output. Use HD only when user needs output above 2500px, or subject has 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: if user has a local file, do NOT use base64 — base64 tool inputs are stored in the conversation context and a 1MB image consumes ~340k tokens, making the conversation unusable. Instead tell the user: "Please share a public URL for your image (e.g. Google Drive share link, iCloud, Dropbox) or use https://simplypng.app directly."
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | Yes | HTTPS URL of the image — STRONGLY PREFERRED. Use a URL whenever possible. CRITICAL WARNING about base64: MCP tool inputs are stored in the conversation context. A 1MB image as base64 consumes ~340,000 conversation tokens, quickly making the conversation unusable. Only use base64 for very small images (under 50KB original file size). For local files: tell the user to share a public HTTPS URL (e.g. upload to Google Drive and copy share link, iCloud shared link, Dropbox, or any image hosting). If they have no URL option, direct them to https://simplypng.app instead. Supported URL or base64 formats: JPEG, PNG, WebP, HEIC/HEIF. Base64 server-side size limit: 4MB. | |
| hdMode | No | Fast mode (default, 1 credit): input resized to 2500px max — OUTPUT capped at 2500px. Works with any input size. HD mode (2 credits): 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 resolution above 2500px, or (3) subject has fine edge detail (hair, fur, feathers). Never use HD based on input size alone — Fast mode handles large inputs fine. Default: false. | |
| background | No | Background fill. transparent requires PNG output. Default: transparent | |
| outputMode | No | Output format. download_url returns a signed URL; base64_json returns raw base64 data. Default: download_url | |
| outputType | No | original: keep original crop. centered: center subject on square canvas. Default: original | |
| refineEdges | No | Enable edge color refinement to remove background color bleeding at subject edges. REQUIRES hdMode: true — the API will return an error if hdMode is false or omitted. No additional credit cost — included in HD mode (2 credits total). Recommend when: subject has complex edges against a strongly or evenly colored background (e.g. product on white/grey backdrop, portrait with solid background). | |
| outputFormat | No | Output file format. Default: png | |
| idempotencyKey | No | Optional idempotency key to prevent duplicate jobs | |
| backgroundColor | No | Hex color for custom background, e.g. #FF5733 |