Background remover API

Background remover API for product photos

Send up to ten product photos in one request and get clean cut-outs back: on transparency for your own layouts, or on white or a brand color with a soft contact shadow, ready for the listing.

Test keys are free and need no pack.

  • Only the outline is drawn: the product's pixels stay your photo's own.
  • Transparent PNG, white, or any hex color, with an optional shadow.
  • Up to 10 photos per request, one credit each.
A green handbag photographed on a wooden table
Input
The same handbag cut out onto pure white
White
POST https://api.garmo.studio/v1/edit/remove-background
{
  "background": "white",
  "shadow": true
}

One request

Every request is asynchronous: the request returns a job in about two seconds, the images follow in 20 to 90 seconds by webhook or by polling.

curl https://api.garmo.studio/v1/edit/remove-background \
  -H "Authorization: Bearer $GARMO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://shop.example/products/bag-77.jpg",
    "background": "white",
    "shadow": true
  }'
Finished job · GET /jobs/{id}
{
  "id": "job_8Kq2xV7mPz4LtR9wNc3B",
  "object": "job",
  "tool": "remove-background",
  "status": "completed",
  "livemode": true,
  "outputs": [
    {
      "id": "out_1",
      "status": "succeeded",
      "label": "White · shadow",
      "url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…0.webp?X-Amz-Signature=…",
      "url_expires_at": "2026-11-20T14:00:00Z"
    }
  ],
  "credits_charged": 1,
  "credits_refunded": 0,
  "metadata": {
    "sku": "DR-123"
  },
  "created_at": "2026-11-19T14:02:11Z",
  "completed_at": "2026-11-19T14:02:58Z"
}

Parameters

backgroundWhat the cut-out sits on.
color_hexThe color when background is "color", like "#efe8dc".
shadowAdds a soft contact shadow under the subject (white and color backgrounds).
Full reference

Cost

1 credit per photo

1 API credit = 1 image. Failed and canceled images are refunded automatically.

API pricing

What people build with it

Catalog clean-up

Bring every product photo onto the same white before a new collection goes live.

Your own layouts

Transparent cut-outs for banners, lookbooks and social posts.

Marketplace rules

White backgrounds where a marketplace asks for them, without a studio.

Prefer to click? Use it in Garmo Studio →

Good to know

Questions, answered.

What developers ask before connecting Garmo to a shop or a workflow.

Still stuck? Email us

What file do I get?

A transparent background returns a PNG with an alpha channel. White and color backgrounds return the same cut-out laid on that background.

Does it work on clothing on a model?

Yes. It separates the subject, product or person, from the background. For a garment on its own with its worn shape, use the ghost mannequin endpoint.

How many photos per request?

Up to ten, in images[]. Each is cut out on its own and costs one credit.

Other edits in the API

Get an API key

Test keys are free and need no pack.