bgCut.net API

curl -X POST https://bgcut.net/api/v1/remove \
  -H "X-Api-Key: bgc_YOUR_API_KEY" \
  -F "[email protected]" \
  -F "size=auto" \
  -F "format=png" \
  -o result.png

# From a URL, white background, cropped, JSON response
curl -X POST https://bgcut.net/api/v1/remove \
  -H "X-Api-Key: bgc_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/photo.jpg","bg_color":"#ffffff","crop":true,"response":"json"}'

import requests

API_KEY = "bgc_YOUR_API_KEY"

with open("photo.jpg", "rb") as f:
    r = requests.post(
        "https://bgcut.net/api/v1/remove",
        headers={"X-Api-Key": API_KEY},
        files={"image_file": f},
        data={"size": "auto", "format": "png"},
        timeout=120,
    )

if r.status_code == 200:
    open("result.png", "wb").write(r.content)
    print("credits charged:", r.headers["X-Credits-Charged"], "remaining:", r.headers["X-Credits-Remaining"])
else:
    print("Error:", r.status_code, r.json())

<?php
$apiKey = 'bgc_YOUR_API_KEY';
$ch = curl_init('https://bgcut.net/api/v1/remove');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . $apiKey],
    CURLOPT_POSTFIELDS => [
        'image_file' => new CURLFile('photo.jpg'),
        'size' => 'auto',
        'format' => 'png',
    ],
    CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($code === 200) {
    file_put_contents('result.png', $body);
} else {
    echo 'Error: ', $body;
}

<?php
// composer require bgcut-net/bgcut-php   ·   https://github.com/bgCut-net/bgcut-php
require 'vendor/autoload.php';

$bg = new BgCut\Client('bgc_YOUR_API_KEY');

// local file → transparent PNG
$result = $bg->removeFile('photo.jpg', ['size' => 'auto', 'model' => 'lite']);
$result->save('photo-nobg.png');
echo "{$result->width}x{$result->height}, {$result->creditsRemaining} credits left\n";

// URL → white background JPG, cropped to the subject
$bg->removeUrl('https://example.com/product.jpg', ['bg_color' => '#ffffff', 'crop' => true, 'format' => 'jpg'])->save('product.jpg');

// errors
try { $bg->removeFile('photo.jpg'); }
catch (BgCut\ApiException $e) { echo $e->errorCode, ' ', $e->httpStatus; } // insufficient_credits 402, rate_limited 429 …

// Node 18+ (built-in fetch & FormData)
import { readFile, writeFile } from 'node:fs/promises';

const API_KEY = 'bgc_YOUR_API_KEY';
const form = new FormData();
form.append('image_file', new Blob([await readFile('photo.jpg')]), 'photo.jpg');
form.append('size', 'auto');
form.append('format', 'png');

const res = await fetch('https://bgcut.net/api/v1/remove', {
  method: 'POST',
  headers: { 'X-Api-Key': API_KEY },
  body: form,
});

if (res.ok) {
  await writeFile('result.png', Buffer.from(await res.arrayBuffer()));
  console.log('credits remaining:', res.headers.get('X-Credits-Remaining'));
} else {
  console.error(await res.json());
}

// Never ship your API key in public front-end code – proxy through your server.
const input = document.querySelector('input[type=file]');
input.addEventListener('change', async () => {
  const form = new FormData();
  form.append('image_file', input.files[0]);
  form.append('size', 'preview');
  const res = await fetch('https://bgcut.net/api/v1/remove', { method: 'POST', headers: { 'X-Api-Key': 'bgc_YOUR_API_KEY' }, body: form });
  const blob = await res.blob();
  document.querySelector('img#out').src = URL.createObjectURL(blob);
});

// Java 11+ HttpClient, no external libraries
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;

public class BgCut {
  public static void main(String[] a) throws Exception {
    String key = "bgc_YOUR_API_KEY";
    String boundary = "----bgcut" + System.nanoTime();
    byte[] file = Files.readAllBytes(Path.of("photo.jpg"));
    String head = "--" + boundary + "\r\nContent-Disposition: form-data; name=\"image_file\"; filename=\"photo.jpg\"\r\nContent-Type: image/jpeg\r\n\r\n";
    String tail = "\r\n--" + boundary + "\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\nauto\r\n--" + boundary + "--\r\n";
    byte[] body = concat(head.getBytes(), file, tail.getBytes());
    HttpRequest req = HttpRequest.newBuilder(URI.create("https://bgcut.net/api/v1/remove"))
        .header("X-Api-Key", key)
        .header("Content-Type", "multipart/form-data; boundary=" + boundary)
        .POST(HttpRequest.BodyPublishers.ofByteArray(body)).build();
    HttpResponse<byte[]> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofByteArray());
    if (res.statusCode() == 200) Files.write(Path.of("result.png"), res.body());
    else System.out.println(new String(res.body()));
  }
  static byte[] concat(byte[]... parts) { int n = 0; for (byte[] p : parts) n += p.length; byte[] out = new byte[n]; int o = 0; for (byte[] p : parts) { System.arraycopy(p, 0, out, o, p.length); o += p.length; } return out; }
}

using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "bgc_YOUR_API_KEY");

using var form = new MultipartFormDataContent();
var fileContent = new ByteArrayContent(await File.ReadAllBytesAsync("photo.jpg"));
fileContent.Headers.ContentType = new MediaTypeHeaderValue("image/jpeg");
form.Add(fileContent, "image_file", "photo.jpg");
form.Add(new StringContent("auto"), "size");
form.Add(new StringContent("png"), "format");

var res = await client.PostAsync("https://bgcut.net/api/v1/remove", form);
if (res.IsSuccessStatusCode)
    await File.WriteAllBytesAsync("result.png", await res.Content.ReadAsByteArrayAsync());
else
    Console.WriteLine(await res.Content.ReadAsStringAsync());

require 'net/http'
require 'uri'

uri = URI('https://bgcut.net/api/v1/remove')
req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = 'bgc_YOUR_API_KEY'
req.set_form([['image_file', File.open('photo.jpg')], ['size', 'auto'], ['format', 'png']], 'multipart/form-data')

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true, read_timeout: 120) { |http| http.request(req) }
if res.code == '200'
  File.binwrite('result.png', res.body)
else
  puts res.body
end

package main

import (
	"bytes"
	"io"
	"mime/multipart"
	"net/http"
	"os"
)

func main() {
	var buf bytes.Buffer
	w := multipart.NewWriter(&buf)
	f, _ := os.Open("photo.jpg")
	defer f.Close()
	fw, _ := w.CreateFormFile("image_file", "photo.jpg")
	io.Copy(fw, f)
	w.WriteField("size", "auto")
	w.Close()

	req, _ := http.NewRequest("POST", "https://bgcut.net/api/v1/remove", &buf)
	req.Header.Set("X-Api-Key", "bgc_YOUR_API_KEY")
	req.Header.Set("Content-Type", w.FormDataContentType())
	res, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer res.Body.Close()
	if res.StatusCode == 200 {
		out, _ := os.Create("result.png")
		defer out.Close()
		io.Copy(out, res.Body)
	} else {
		io.Copy(os.Stderr, res.Body)
	}
}