logobgbuster
Background Removal API

Remove image backgrounds in C#

MultipartFormDataContent is built into .NET's HttpClient, so this works in an ASP.NET Core service, a console tool, or a Unity editor script with no extra packages.

Quickstart

Remove a background

csharp
using var client = new HttpClient();
using var content = new MultipartFormDataContent();
content.Add(new StreamContent(File.OpenRead("photo.jpg")), "input", "photo.jpg");
content.Add(new StringContent("png"), "format");

client.DefaultRequestHeaders.Add("X-Api-Key", "your-api-key");

var response = await client.PostAsync("https://api.bgbuster.com/images/remove-background", content);
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);
How it works

The request is a multipart POST to https://api.bgbuster.com/images/remove-background, authenticated with your API key in the X-Api-Key header. Pass the image as a file (input) or as a public URL string.

By default the response is JSON with a temporary download url. That URL stays valid for 24 hours — download and store the image yourself if you need it longer.

Need more than a plain removal? POST /images/edit takes the same kind of request and chains background removal together with resize, rotate, flip, blur, brightness/contrast/saturation, and trim — in whatever order you list them.

Parameters
FieldTypeRequiredDescription
inputFile or stringYesImage file or a public URL to fetch it from.
output"url" or "raw"NoReturn a temporary download URL, or the transformed image bytes directly. Defaults to "url".
format"png" or "webp"NoOutput image format. Defaults to "png".
trimbooleanNoTrim empty transparent space around the result.
Response

Default (output=url)

json
{
  "id": "image-id",
  "url": "https://..."
}

With output=raw, save the image bytes directly instead of following a URL

csharp
using var client = new HttpClient();
using var content = new MultipartFormDataContent();
content.Add(new StreamContent(File.OpenRead("photo.jpg")), "input", "photo.jpg");
content.Add(new StringContent("png"), "format");
content.Add(new StringContent("raw"), "output");

client.DefaultRequestHeaders.Add("X-Api-Key", "your-api-key");

var response = await client.PostAsync("https://api.bgbuster.com/images/remove-background", content);
var bytes = await response.Content.ReadAsByteArrayAsync();
await File.WriteAllBytesAsync("result.png", bytes);
Errors
StatusCodeMeaning
400IMAGE_TOO_LARGEThe input image exceeds the size limit.
400IMAGE_DECODE_ERRORThe input file couldn't be decoded as an image.
400INVALID_IMAGE_URLThe URL passed as input didn't return image content.
400UPSTREAM_ERRORThe input URL couldn't be fetched.
401UNAUTHORIZEDThe API key is missing or invalid.
402INSUFFICIENT_BALANCEYour account is out of credits.
403IMAGE_FORBIDDENThe source CDN blocked the request for the input URL.
429TOO_MANY_REQUESTSRate limit exceeded — retry after a short delay.
500IMAGE_TRANSFORMATION_ERRORThe background removal step failed unexpectedly.
Getting an API key
  1. 1

    Create an account

    Sign up with an email or a social login — no credit card required.

  2. 2

    Add credits

    Buy a credit pack. Credits never expire, and you'll need a balance before the API accepts requests.

  3. 3

    Create an API key

    From the dashboard, go to API Keys and click Create API key.

  4. 4

    Authenticate your requests

    Send the key in the X-Api-Key header on every request to api.bgbuster.com.

Try it yourself
No signup required — drop an image in and see the result before you write any code.