Name: 851 Labs – AI Background Removal | Pay Per Call | API.market
Brand: magicapi
SKU: api-magicapi-background-remover-851-labs-background-remover
Availability: InStock
Author: API Market

Shashank Agarwal

# 🖼️ High-Quality Background Remover API (851-Labs)

## Overview
The High-Quality Background Remover API by 851-Labs offers a powerful solution for automatically removing backgrounds from images with high precision and speed. Ideal for e-commerce, media, and various other digital applications, this API simplifies the process of foreground-background segmentation, enabling users to prepare visuals for product listings, marketing materials, and more.

## Features
- **AI-Powered Precision**: Leverages advanced artificial intelligence models to accurately identify and remove backgrounds from images.
- **Flexible Output**: Supports multiple output formats, including PNG and JPEG, with customizable background types.
- **Reverse Mode**: Optionally remove the foreground instead of the background.
- **Custom Thresholds**: Adjustable thresholds for hard segmentation to suit specific needs.
- **Various Background Types**: Choose from 'rgba', 'map', 'green', 'white', array [R,G,B], 'blur', 'overlay', or provide a custom image path.
- **Asynchronous Processing**: Efficient handling of predictions through asynchronous processing and status polling.

## Use Cases
- **E-Commerce Product Listings**: Remove backgrounds from product images to create clean and professional listings.
- **Marketing and Advertising**: Create stunning visuals by isolating products or subjects for promotional material.
- **Media and Publishing**: Automate background removal for photos used in articles, blogs, and online media.
- **Social Media Content Creation**: Enhance social media posts by creating eye-catching images with transparent backgrounds.
- **Graphic Design Projects**: Integrate the API into design workflows to streamline the process of image editing and background removal.

## Visual Examples
### Example Input and Output
#### Input Image
![Input Image](https://blog.api.market/wp-content/uploads/2026/02/dinosour-api-market.png)

#### Output Image
![Output Image](https://blog.api.market/wp-content/uploads/2026/02/dinosour-output-bg-remover-api-market.png)

## Pricing
- **Pay As You Go (PAYG)**: Pay only for what you use; no subscription fees or usage limits.
- **1 API Unit = 1 Processed Image**: Simple and transparent pricing model.
- **Free GET Requests**: Status checks using `GET /api/v1/magicapi/background-remover-851-labs-background-remover/predictions/{id}` do not count towards API unit usage.

## API Documentation

### Base URL
All API requests should be made to:
```
https://prod.api.market/api/v1/magicapi/background-remover-851-labs-background-remover
```

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```http
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
**IMPORTANT**: This API uses asynchronous processing for predictions. Follow this typical flow:

1. **Submit a prediction request** to the POST endpoint.
2. **Receive a prediction ID** in the response.
3. **Poll the GET endpoint** with the prediction ID to check status.
4. **Continue polling** until the prediction is complete.

Suggested polling interval:
- **1 second** between status checks.
- **Maximum timeout** of 600 seconds (10 minutes).

### Endpoints

#### Create a Prediction
**Endpoint**: `POST /api/v1/magicapi/background-remover-851-labs-background-remover/predictions`

**Description**: Run inference with the 851-labs/background-remover model.

**Request Body**:
```json
{
  "version": "a029dff38972b5fda4ec5d75d7d1cd25aeff621d2cf4946a41055d7db66b80bc",
  "input": {
    "image": "https://example.com/image.jpg",
    "format": "png",
    "reverse": false,
    "threshold": 0,
    "background_type": "rgba"
  }
}
```

**Response**:
```json
{
  "id": "prediction_id",
  "version": "a029dff38972b5fda4ec5d75d7d1cd25aeff621d2cf4946a41055d7db66b80bc",
  "status": "starting",
  "created_at": "2023-01-01T12:00:00.000Z"
}
```

**Example cURL**:
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/background-remover-851-labs-background-remover/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "a029dff38972b5fda4ec5d75d7d1cd25aeff621d2cf4946a41055d7db66b80bc",
    "input": {
      "image": "https://example.com/image.jpg"
    }
  }'
```

#### Get Prediction Status
**Endpoint**: `GET /api/v1/magicapi/background-remover-851-labs-background-remover/predictions/{id}`

**Description**: Get the status and details of a specific prediction.

**Request**:
```http
GET /api/v1/magicapi/background-remover-851-labs-background-remover/predictions/{id}
```

**Response**:
```json
{
  "id": "prediction_id",
  "status": "succeeded",
  "output": "https://blog.api.market/wp-content/uploads/2026/02/dinosour-output-bg-remover-api-market.png",
  "created_at": "2023-01-01T12:00:00.000Z",
  "started_at": "2023-01-01T12:00:05.000Z",
  "completed_at": "2023-01-01T12:01:00.000Z"
}
```

**Example cURL**:
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/background-remover-851-labs-background-remover/predictions/{id}" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Status Codes
- **200 OK**: Request successful.
- **201 Created**: Resource successfully created.
- **400 Bad Request**: Invalid input parameters or malformed request.
- **401 Unauthorized**: Missing or invalid API key.
- **403 Forbidden**: Valid API key but insufficient permissions.
- **404 Not Found**: Resource not found.
- **429 Too Many Requests**: Rate limit exceeded.
- **500 Internal Server Error**: Server-side error.
- **503 Service Unavailable**: Service temporarily unavailable.

### Rate Limits
- Adhere to the specified rate limits for API usage.
- Exceeding the limit results in a `429 Too Many Requests` status.
- Implement retry logic with exponential backoff to handle rate limiting.

## Error Handling
- **Interpret Error Responses**: Check the `error` field in the response to understand the cause.
- **Common Errors**: Address missing parameters or invalid inputs promptly.
- **Retry Strategies**: Implement retries with exponential backoff for transient errors.

**Example Error Response**:
```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'image' is required",
    "status": 400
  }
}
```

## Implementation Guide

### Example Code

#### JavaScript (Node.js)
```javascript
const fetch = require('node-fetch');

const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/background-remover-851-labs-background-remover";

async function createAndWaitForPrediction(inputData) {
  try {
    const response = await fetch(`${baseUrl}/predictions`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-market-key": apiKey
      },
      body: JSON.stringify({
        version: "a029dff38972b5fda4ec5d75d7d1cd25aeff621d2cf4946a41055d7db66b80bc",
        input: inputData
      })
    });
    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }
    const prediction = await response.json();
    const predictionId = prediction.id;
    return await pollForResults(predictionId);
  } catch (error) {
    console.error("Error:", error);
    throw error;
  }
}

function delay(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function pollForResults(predictionId) {
  const MAX_TIMEOUT = 600000; // 600 seconds (10 minutes)
  const POLL_INTERVAL = 1000; // 1 second between checks
  const startTime = Date.now();

  while (Date.now() - startTime < MAX_TIMEOUT) {
    const response = await fetch(`${baseUrl}/predictions/${predictionId}`, {
      headers: { "x-api-market-key": apiKey }
    });
    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }
    const prediction = await response.json();
    if (prediction.status === "succeeded") {
      return prediction.output;
    }
    if (prediction.status === "failed") {
      throw new Error(`Prediction failed: ${prediction.error || "Unknown error"}`);
    }
    await delay(POLL_INTERVAL);
  }
  throw new Error("Prediction timed out after 10 minutes");
}

// Example usage
createAndWaitForPrediction({
  image: "https://example.com/image.jpg",
  format: "png",
  reverse: false,
  threshold: 0,
  background_type: "rgba"
}).then(output => {
  console.log("Prediction output:", output);
}).catch(error => {
  console.error("Error during prediction:", error);
});
```

#### Python
```python
import requests
import time

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/background-remover-851-labs-background-remover"

def create_and_wait_for_prediction(input_data):
    headers = {
        "Content-Type": "application/json",
        "x-api-market-key": API_KEY
    }
    response = requests.post(
        f"{BASE_URL}/predictions",
        headers=headers,
        json={"version": "a029dff38972b5fda4ec5d75d7d1cd25aeff621d2cf4946a41055d7db66b80bc", "input": input_data}
    )
    if response.status_code != 200:
        raise Exception(f"API error: {response.status_code} {response.text}")
    prediction = response.json()
    prediction_id = prediction["id"]
    return poll_for_results(prediction_id)

def poll_for_results(prediction_id):
    MAX_TIMEOUT = 600  # 600 seconds (10 minutes)
    POLL_INTERVAL = 1  # 1 second between checks
    headers = {"x-api-market-key": API_KEY}
    start_time = time.time()

    while time.time() - start_time < MAX_TIMEOUT:
        response = requests.get(f"{BASE_URL}/predictions/{prediction_id}", headers=headers)
        if response.status_code != 200:
            raise Exception(f"API error: {response.status_code} {response.text}")
        prediction = response.json()
        if prediction["status"] == "succeeded":
            return prediction["output"]
        if prediction["status"] == "failed":
            error_msg = prediction.get("error", "Unknown error")
            raise Exception(f"Prediction failed: {error_msg}")
        time.sleep(POLL_INTERVAL)
    raise Exception("Prediction timed out after 10 minutes")
    
# Example usage
output = create_and_wait_for_prediction({
    "image": "https://example.com/image.jpg",
    "format": "png",
    "reverse": False,
    "threshold": 0,
    "background_type": "rgba"
})
print("Prediction output:", output)
```

#### cURL
```bash
# Example for creating a prediction
curl -X POST "https://prod.api.market/api/v1/magicapi/background-remover-851-labs-background-remover/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "a029dff38972b5fda4ec5d75d7d1cd25aeff621d2cf4946a41055d7db66b80bc",
    "input": {
      "image": "https://example.com/image.jpg",
      "format": "png",
      "reverse": false,
      "threshold": 0,
      "background_type": "rgba"
    }
  }'

# Example for getting the prediction status
curl -X GET "https://prod.api.market/api/v1/magicapi/background-remover-851-labs-background-remover/predictions/{id}" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization
- **Minimize Image Sizes**: Provide smaller input images to save on processing time and costs.
- **Bulk Processing**: Optimize for bulk processing scenarios by handling multiple predictions concurrently.
- **Efficient Polling**: Limit the number of status checks by implementing proper polling intervals and timeouts.

## FAQ
**Q: What image formats does the API support?**
A: The API supports various image formats for input, such as JPEG, PNG, and more. The output can be PNG or JPEG.

**Q: How long does it take to process an image?**
A: Processing time varies based on the complexity of the image and the API load but typically completes within a few seconds to a couple of minutes.

**Q: Is there a limit to the number of images I can process?**
A: No, there are no usage limits. You can process as many images as needed under the Pay As You Go (PAYG) model.

**Q: What happens if an API request fails?**
A: If a request fails, an error message will be returned. Depending on the error code, you may need to adjust your request or retry the operation.

**Q: Can I remove the foreground instead of the background?**
A: Yes, by setting the `reverse` parameter to `true`, you can remove the foreground instead of the background.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello[at]api.market.

---

This documentation is designed to provide developers and AI engineers with a comprehensive guide to using the High-Quality Background Remover API (851-Labs). Follow these guidelines and examples to effectively integrate and use this powerful API in your applications.

Automatically remove image backgrounds with high precision. Supports PNG & JPEG output with an option to remove the foreground. Try it free on API.market.