Background Removal

Detect and Remove BackgroundAPI

Removes solid background while preserving detected prompted elements

Test in Dashboard View Docs ← All Tools

Three ways to use this tool

REST API

One POST request. Get the result back directly — as an image, video, or JSON depending on the tool.

terminal 
curl -X POST https://apiai.me/api/workflow/detect-and-remove-background \
     -H "X-API-Key: YOUR_API_KEY" \
     -F "image=@input.jpg" \
     -F "bg_color=auto" \
     -F "box_threshold=0.25" \
     -F "feather=1" \
     -F "query=emblem or shield or badge" \
     -F "remove_holes_threshold=2" \
     -F "tolerance=20"
     --output result.png

Dashboard Playground

Test this tool visually before writing any code. Upload an image, set parameters, and see the result live. When it looks right, copy the auto-generated curl command and paste it into your app.

  1. Open the dashboard → API Toolbox
  2. Find Detect and Remove Background and click it
  3. Upload your input and adjust parameters
  4. Copy the curl command and ship
Open Dashboard →

Batch Processing

Process hundreds of images at once without writing a loop. Upload a CSV with one row per item, set your parameters, and download the results as a ZIP when they're done.

  1. Open the dashboard → Batches
  2. Select Detect and Remove Background
  3. Add your content and start the batch
  4. Download results ZIP when complete
Go to Batches →

Parameters

Name Required Description Default / Options
bg_color optional Background color: 'auto' or hex like '#FFFFFF' auto
box_threshold optional DINO confidence threshold 0.25
feather optional Edge softness in pixels (0-3) 1
query optional DINO detection prompt emblem or shield or badge
remove_holes_threshold optional Remove islands smaller than X% outside protected zone 2
tolerance optional Color distance for flood fill (0-255) 20

Ready to integrate?

Get an API key, test Detect and Remove Background in the dashboard, and copy the curl command.

Get API Key Full API Reference