API docs / Image models

background-remover API

Remove image backgrounds

Model id
851-labs/background-remover
Provider
851-labs
Output
Image
Price
From 1 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "851-labs/background-remover". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "851-labs/background-remover",
  "input": {
    "reference_images": [
      "https://example.com/input.png"
    ]
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
reference_imagesrequiredarray of URLs

Input image

Up to 1 files · Accepts image/*

output_formatstring

Output format (e.g., png, jpg). Defaults to png.

Default: png

background_typestring

Background type: 'rgba', 'map', 'green', 'white', [R,G,B] array, 'blur', 'overlay', or path to an image.

Default: rgba

reverseboolean

If true, remove the foreground instead of the background.

Default: false

thresholdnumber

Threshold for hard segmentation (0.0-1.0). If 0.0, uses soft alpha.

Default: 0