# Background Remover

> The most-used background remover on Replicate (27M+ runs). Removes backgrounds with soft alpha or hard segmentation, supports reverse mode, custom background types, and png/jpg output.

- **Provider**: replicate
- **Model ID**: 851-labs/background-remover
- **Category**: background_removal
- **Credits**: 1 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `format` (string, optional): Output format (e.g., png, jpg). Defaults to png. (Default: `png`)
- `image` (string, **required**): Input image
- `threshold` (number, optional): Threshold for hard segmentation (0.0-1.0). If 0.0, uses soft alpha. (Default: `0`)
- `reverse` (boolean, optional): If True, remove the foreground instead of the background. (Default: `False`)
- `background_type` (string, optional): Background type: 'rgba', 'map', 'green', 'white', [R,G,B] array, 'blur', 'overlay', or path to an image. (Default: `rgba`)

## Example Request

```json
{
  "model": "851-labs/background-remover",
  "input": {
    "format": "png",
    "image": "https://replicate.delivery/pbxt/MAqakpYnuaS5IxU4WZAh5irkSn92wuYc5bdU1TNV5xzIJ8sM/gzp35qt55t4aatwznmccv2ssgds2.png",
    "threshold": 0,
    "reverse": false,
    "background_type": "rgba"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

background-removal, image-editing, segmentation, alpha-matte, open-source

## Documentation

https://replicate.com/851-labs/background-remover