Background Removal API

Remove the background
of any image*
with 1 API call

$ curl -H 'X-API-Key: YOUR_API_KEY' \ -F '[email protected]/path/to/file.jpg' \ -f https://api.remove.bg/v1.0/removebg -o no-bg.png

$ curl -H 'X-API-Key: YOUR_API_KEY' \ -F '[email protected]/path/to/file.jpg' \ -f https://api.remove.bg/v1.0/removebg \ -o no-bg.png

Get API Key

* Currently supported: Photos of persons. More coming soon.

Easy to integrate

Our API is a simple HTTP interface with various options:

Source images: Direct uploads or URL reference
Result images: Image file or JSON-encoded data
Output resolution: up to 10 megapixels
Requires images with persons in them (more coming soon)

Get started

Get an API Key. Your first 50 API calls per month are on us (see Pricing).
Use the following code samples to get started quickly
Review the reference docs to adjust any parameters

Sample Code

Remove background from

Environment

Code

$ curl -H 'X-API-Key: INSERT_YOUR_API_KEY_HERE'           \
       -F '[email protected]/path/to/file.jpg'                 \
       -F 'size=auto'                                     \
       -f https://api.remove.bg/v1.0/removebg -o no-bg.png

// Requires "request" to be installed (see https://www.npmjs.com/package/request)
var request = require('request');
var fs = require('fs');

request.post({
  url: 'https://api.remove.bg/v1.0/removebg',
  formData: {
    image_file: fs.createReadStream('/path/to/file.jpg'),
    size: 'auto',
  },
  headers: {
    'X-Api-Key': 'INSERT_YOUR_API_KEY_HERE'
  },
  encoding: null
}, function(error, response, body) {
  if(error) return console.error('Request failed:', error);
  if(response.statusCode != 200) return console.error('Error:', response.statusCode, body.toString('utf8'));
  fs.writeFileSync("no-bg.png", body);
});

# Requires "requests" to be installed (see python-requests.org)
import requests

response = requests.post(
    'https://api.remove.bg/v1.0/removebg',
    files={'image_file': open('/path/to/file.jpg', 'rb')},
    data={'size': 'auto'},
    headers={'X-Api-Key': 'INSERT_YOUR_API_KEY_HERE'},
)
if response.status_code == requests.codes.ok:
    with open('no-bg.png', 'wb') as out:
        out.write(response.content)
else:
    print("Error:", response.status_code, response.text)

# Requires "faraday" to be installed (see https://github.com/lostisland/faraday)
require "faraday"

conn = Faraday.new('https://api.remove.bg', headers: {
  "X-Api-Key" => 'INSERT_YOUR_API_KEY_HERE'
}) do |f|
  f.request :multipart
  f.request :url_encoded
  f.adapter :net_http
end

response = conn.post('/v1.0/removebg',
  image_file: Faraday::UploadIO.new('/path/to/file.jpg', 'image/jpeg'),
  size: 'auto'
)

if response.success?
  File.write('no-bg.png', response.body)
else
  puts "Error: #{response.status} #{response.body}"
end

// Requires "guzzle" to be installed (see guzzlephp.org)

$client = new GuzzleHttp\Client();
$res = $client->post('https://api.remove.bg/v1.0/removebg', [
    'multipart' => [
        [
            'name'     => 'image_file',
            'contents' => fopen('/path/to/file.jpg', 'r')
        ],
        [
            'name'     => 'size',
            'contents' => 'auto'
        ]
    ],
    'headers' => [
        'X-Api-Key' => 'INSERT_YOUR_API_KEY_HERE'
    ]
]);

$fp = fopen("no-bg.png", "wb");
fwrite($fp, $res->getBody());
fclose($fp);

// Requires "Apache HttpComponents" to be installed (see hc.apache.org)

Response response = Request.Post("https://api.remove.bg/v1.0/removebg")
    .addHeader("X-Api-Key", "INSERT_YOUR_API_KEY_HERE")
    .body(
        MultipartEntityBuilder.create()
        .addBinaryBody("image_file", new File("/path/to/file.jpg"))
        .addTextBody("size", "auto")
        .build()
    ).execute();
response.saveContent(new File("no-bg.png"));

// This code sample uses http://unirest.io/objective-c
NSURL *urlimage_file = [NSURL URLWithString:@"/path/to/file.jpg"]
NSDictionary *headers = @{@"X-Api-Key": @"INSERT_YOUR_API_KEY_HERE"};
NSDictionary *parameters = @{@"image_file": urlimage_file};
UNIUrlConnection *asyncConnection = [[UNIRest post:^(UNISimpleRequest *request) {
  [request setUrl:@"https://api.remove.bg/v1.0/removebg"];
  [request setHeaders:headers];
  [request setParameters:parameters];
}] asBinaryAsync:^(UNIHTTPBinaryResponse *response, NSError *error) {
  NSInteger code = response.code;
  NSDictionary *responseHeaders = response.headers;
  UNIJsonNode *body = response.body;
  NSData *rawBody = response.rawBody;
}];

using (var client = new HttpClient())
using (var formData = new MultipartFormDataContent())
{
    formData.Headers.Add("X-Api-Key", "INSERT_YOUR_API_KEY_HERE");
    formData.Add(new ByteArrayContent(File.ReadAllBytes("/path/to/file.jpg")), "image_file", "file.jpg");
    formData.Add(new StringContent("auto"), "size");
    var response = client.PostAsync("https://api.remove.bg/v1.0/removebg", formData).Result;

    if(response.IsSuccessStatusCode) {
        FileStream fileStream = new FileStream("no-bg.png", FileMode.Create, FileAccess.Write, FileShare.None);
        response.Content.CopyToAsync(fileStream).ContinueWith((copyTask) =>{ fileStream.Close(); });
    } else {
        Console.WriteLine("Error: " + response.Content.ReadAsStringAsync().Result);
    }
}

$ curl -H 'X-API-Key: INSERT_YOUR_API_KEY_HERE'           \
       -d 'image_url=https://www.remove.bg/example.jpg'   \
       -F 'size=auto'                                     \
       -f https://api.remove.bg/v1.0/removebg -o no-bg.png

// Requires "request" to be installed (see https://www.npmjs.com/package/request)
var request = require('request');
var fs = require('fs');

request.post({
  url: 'https://api.remove.bg/v1.0/removebg',
  formData: {
    image_url: 'https://www.remove.bg/example.jpg',
    size: 'auto',
  },
  headers: {
    'X-Api-Key': 'INSERT_YOUR_API_KEY_HERE'
  },
  encoding: null
}, function(error, response, body) {
  if(error) return console.error('Request failed:', error);
  if(response.statusCode != 200) return console.error('Error:', response.statusCode, body.toString('utf8'));
  fs.writeFileSync("no-bg.png", body);
});

# Requires "requests" to be installed (see python-requests.org)
import requests

response = requests.post(
    'https://api.remove.bg/v1.0/removebg',
    data={
        'image_url': 'https://www.remove.bg/example.jpg',
        'size': 'auto'
    },
    headers={'X-Api-Key': 'INSERT_YOUR_API_KEY_HERE'},
)
if response.status_code == requests.codes.ok:
    with open('no-bg.png', 'wb') as out:
        out.write(response.content)
else:
    print("Error:", response.status_code, response.text)

# Requires "faraday" to be installed (see https://github.com/lostisland/faraday)
require "faraday"

conn = Faraday.new('https://api.remove.bg', headers: {
  "X-Api-Key" => 'INSERT_YOUR_API_KEY_HERE'
}) do |f|
  f.request :multipart
  f.request :url_encoded
  f.adapter :net_http
end

response = conn.post('/v1.0/removebg',
  image_url: 'https://www.remove.bg/example.jpg',
  size: 'auto'
)

if response.success?
  File.write('no-bg.png', response.body)
else
  puts "Error: #{response.status} #{response.body}"
end

// Requires "guzzle" to be installed (see guzzlephp.org)

$client = new GuzzleHttp\Client();
$res = $client->post('https://api.remove.bg/v1.0/removebg', [
    'multipart' => [
        [
            'name'     => 'image_url',
            'contents' => 'https://www.remove.bg/example.jpg'
        ],
        [
            'name'     => 'size',
            'contents' => 'auto'
        ]
    ],
    'headers' => [
        'X-Api-Key' => 'INSERT_YOUR_API_KEY_HERE'
    ]
]);

$fp = fopen("no-bg.png", "wb");
fwrite($fp, $res->getBody());
fclose($fp);

// Requires "Apache HttpComponents" to be installed (see hc.apache.org)

Response response = Request.Post("https://api.remove.bg/v1.0/removebg")
    .addHeader("X-Api-Key", "INSERT_YOUR_API_KEY_HERE")
    .body(
        MultipartEntityBuilder.create()
        .addTextBody("image_url", "https://www.remove.bg/example.jpg")
        .addTextBody("size", "auto")
        .build()
    ).execute();
response.saveContent(new File("no-bg.png"));

// This code sample uses http://unirest.io/objective-c
NSDictionary *headers = @{@"X-Api-Key": @"INSERT_YOUR_API_KEY_HERE"};
NSDictionary *parameters = @{@"image_url": @"https://www.remove.bg/example.jpg"};
UNIUrlConnection *asyncConnection = [[UNIRest post:^(UNISimpleRequest *request) {
  [request setUrl:@"https://api.remove.bg/v1.0/removebg"];
  [request setHeaders:headers];
  [request setParameters:parameters];
}] asBinaryAsync:^(UNIHTTPBinaryResponse *response, NSError *error) {
  NSInteger code = response.code;
  NSDictionary *responseHeaders = response.headers;
  UNIJsonNode *body = response.body;
  NSData *rawBody = response.rawBody;
}];

using (var client = new HttpClient())
using (var formData = new MultipartFormDataContent())
{
    formData.Headers.Add("X-Api-Key", "INSERT_YOUR_API_KEY_HERE");
    formData.Add(new StringContent("https://www.remove.bg/example.jpg"), "image_url");
    formData.Add(new StringContent("auto"), "size");
    var response = client.PostAsync("https://api.remove.bg/v1.0/removebg", formData).Result;

    if(response.IsSuccessStatusCode) {
        FileStream fileStream = new FileStream("no-bg.png", FileMode.Create, FileAccess.Write, FileShare.None);
        response.Content.CopyToAsync(fileStream).ContinueWith((copyTask) =>{ fileStream.Close(); });
    } else {
        Console.WriteLine("Error: " + response.Content.ReadAsStringAsync().Result);
    }
}

Community

API wrapper for PHP / Laravel by @mtownsend5512
API wrapper for Node.js by @eddyverbruggen
API wrapper for Python by Brian Lam