Remove background
remove_backgroundRemove the background from an image and return a transparent PNG/WebP, or place the subject on white, a colour, a gradient or a built-in scene, optionally at a marketplace size (Amazon, Shopify, Etsy, eBay, Instagram). Costs 1 credit (hd 2, ultra 4); free credits export up to 2 MP.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "remove_background"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crop | No | Trim the result to the subject. | |
| size | No | original: Same pixels as your upload; amazon: 2000², pure white, product fills ~85%; shopify: 2048² square, zoom-ready; etsy: 2000×1600, 5:4 thumbnail-safe; ebay: 1600², white; instagram: 1080×1350 portrait post; story: 1080×1920 vertical | |
| format | No | Output format. png keeps transparency everywhere; webp is smaller; jpg has no transparency. | |
| shadow | No | Add a shadow under the subject when it's placed on a background. | |
| quality | No | preview 0.25 MP, standard 4 MP (default), hd 25 MP, ultra 50 MP. hd and ultra need paid credits. | |
| subject | No | main drops small stray objects and keeps the main subject. | |
| image_url | No | Public http(s) URL of a JPG, PNG or WebP image (up to 25 MB). | |
| background | No | transparent (default), white, a hex colour such as #F5F5F5, gradient:#a,#b, or scene:<id> with one of: plinth, marble, linen, pastel, noir, garden, kitchen, concrete, signal, festive. | |
| image_base64 | No | The image as base64 (or a data: URL), if there is no public URL. Prefer image_url for large files. |