Remove background from image (Recraft + fal.ai BiRefNet v2 fallback)
aetherwave_remove_backgroundStrips the background from an image, returning a PNG with transparent alpha. Pass a public imageUrl. Useful for product shots, character cutouts, logo isolation, or compositing onto a new background. ~5 credits per image. Recraft is the primary provider; on outage the tool auto-falls back to fal.ai BiRefNet v2 so single-image calls never silently fail. Works best on photographic subjects (people, products, animals); transparent-PNG inputs have no foreground to segment.
Returns within ~45 s. If the result has state "running" the job is still rendering: poll aetherwave_get_job with the returned taskId and kind every ~10 s. Pass wait:true ONLY if your MCP client permits tool calls longer than 60 s (most do not). Pass async:true to get the taskId back immediately without waiting.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Block until the job finishes (up to the tool's full budget, 6-15 minutes). ONLY if your MCP client permits tool calls longer than 60 s; most abandon the call at 60 s and lose the taskId. Default false: return within ~45 s and hand back a taskId if still running. | |
| async | No | Submit and return the taskId immediately without polling at all. Then poll aetherwave_get_job(taskId, kind). | |
| imageUrl | Yes | Public URL of the source image. |