Background Removal API

Remove image backgrounds automatically using our powerful AI API. Perfect for e-commerce products, profile pictures, or any image that needs a clean, professional look.

Remove, blur or replace image backgrounds with one API call

Generate precise masks for foreground and background editing

Process images via URL or file upload in PNG, WebP formats

Get API Token View Dashboard →

Remove image background from URL

Send an image URL to our API and get back the processed image without background. Perfect for processing images that are already hosted online.

curl -X POST https://api.removebg.sh/v1/remove \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "format": "png"
  }'

const response = await fetch('https://api.removebg.sh/v1/remove', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    image_url: 'https://example.com/image.jpg',
    format: 'png'
  })
})

const data = await response.json()
console.log(data.image_url) // URL of processed image

import requests

response = requests.post(
    'https://api.removebg.sh/v1/remove',
    headers={
        'Authorization': 'Bearer YOUR_API_TOKEN'
    },
    json={
        'image_url': 'https://example.com/image.jpg',
        'format': 'png'
    }
)

data = response.json()
print(data['image_url'])  # URL of processed image

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.removebg.sh/v1/remove')
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer YOUR_API_TOKEN'
req['Content-Type'] = 'application/json'
req.body = {
  image_url: 'https://example.com/image.jpg',
  format: 'png'
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

data = JSON.parse(response.body)
puts data['image_url'] # URL of processed image

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.removebg.sh/v1/remove',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_TOKEN',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'image_url' => 'https://example.com/image.jpg',
        'format' => 'png'
    ])
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
echo $data['image_url']; // URL of processed image

curl_close($ch);

package main

import (
    "bytes"
    "encoding/json"
    "io/ioutil"
    "net/http"
)

func main() {
    data := map[string]string{
        "image_url": "https://example.com/image.jpg",
        "format":    "png",
    }

    jsonData, err := json.Marshal(data)
    if err != nil {
        panic(err)
    }

    req, err := http.NewRequest("POST", "https://api.removebg.sh/v1/remove",
        bytes.NewBuffer(jsonData))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    var result map[string]interface{}
    json.Unmarshal(body, &result)

    imageURL := result["image_url"].(string)
    // Use the processed image URL

Remove image background by upload

Upload an image directly from your computer or server. Useful when working with local files or user uploads.

curl -X POST https://api.removebg.sh/v1/upload \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "image=@/path/to/image.jpg"

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.removebg.sh/v1/upload')
req = Net::HTTP::Post::Multipart.new(uri,
  'image' => UploadIO.new(File.open('image.jpg'), 'image/jpeg', 'image.jpg')
)
req['Authorization'] = 'Bearer YOUR_API_TOKEN'

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

data = JSON.parse(res.body)

const formData = new FormData()
formData.append('image', file)  // file from input or File/Blob object

const response = await fetch('https://api.removebg.sh/v1/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  body: formData
})

const data = await response.json()
console.log(data.image_url) // URL of processed image

import requests

files = {
    'image': open('image.jpg', 'rb')
}

response = requests.post(
    'https://api.removebg.sh/v1/upload',
    headers={
        'Authorization': 'Bearer YOUR_API_TOKEN'
    },
    files=files
)

data = response.json()
print(data['image_url'])  # URL of processed image

package main

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

func main() {
    // Create buffer to store multipart data
    var buffer bytes.Buffer
    writer := multipart.NewWriter(&buffer)

    // Add file
    file, _ := os.Open("image.jpg")
    defer file.Close()
    part, _ := writer.CreateFormFile("image", "image.jpg")
    io.Copy(part, file)
    writer.Close()

    // Create request
    req, _ := http.NewRequest("POST", "https://api.removebg.sh/v1/upload", &buffer)
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
    req.Header.Set("Content-Type", writer.FormDataContentType())

    // Send request
    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    // Parse response
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    imageURL := result["image_url"].(string)

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.removebg.sh/v1/upload',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_TOKEN'
    ],
    CURLOPT_POSTFIELDS => [
        'image' => new CURLFile('path/to/image.jpg')
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
echo $data['image_url']; // URL of processed image

curl_close($ch);

Generate masks

Get a black and white mask of your image where white represents the foreground and black represents the background. Useful for advanced image editing and compositing.

curl -X POST https://api.removebg.sh/v1/mask \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/image.jpg"}'

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.removebg.sh/v1/mask')
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer YOUR_API_TOKEN'
req['Content-Type'] = 'application/json'
req.body = {
  image_url: 'https://example.com/image.jpg'
}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

data = JSON.parse(res.body)

const response = await fetch('https://api.removebg.sh/v1/mask', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    image_url: 'https://example.com/image.jpg'
  })
})

const data = await response.json()
console.log(data.mask_url) // URL of generated mask

import requests

response = requests.post(
    'https://api.removebg.sh/v1/mask',
    headers={
        'Authorization': 'Bearer YOUR_API_TOKEN'
    },
    json={
        'image_url': 'https://example.com/image.jpg'
    }
)

data = response.json()
print(data['mask_url'])  # URL of generated mask

package main

import (
    "bytes"
    "encoding/json"
    "io/ioutil"
    "net/http"
)

func main() {
    data := map[string]string{
        "image_url": "https://example.com/image.jpg",
    }

    jsonData, err := json.Marshal(data)
    if err != nil {
        panic(err)
    }

    req, err := http.NewRequest("POST", "https://api.removebg.sh/v1/mask",
        bytes.NewBuffer(jsonData))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)

    maskURL := result["mask_url"].(string)
    // Use the generated mask URL

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.removebg.sh/v1/mask',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_TOKEN',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'image_url' => 'https://example.com/image.jpg'
    ])
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
echo $data['mask_url']; // URL of generated mask

curl_close($ch);

API Reference

RESTful API for removing image backgrounds using AI

Remove Background from URL

POST /v1/remove

Remove background from an image provided via URL

Authorization

Bearer token required in Authorization header

Request Parameters

Parameter	Type	Required	Default	Description
image_url	String	Yes	-	URL of the image to process
format	String	No	png	Output format: 'png' or 'webp'
color	String	No		Valid RGB color: rgb(255, 0, 0)
blur	Boolean	No		Blur background instead of remove.
reverse	Boolean	No	false	If true, removes foreground instead of background

Response (200 OK)

{
  "image_url": "https://storage.example.com/u/{uuid}/bg/{id}.png",
  "size_mb": 0.45,
  "width": 1024,
  "height": 768
}

Example Request

curl -X POST http://api.removebg.sh/v1/remove \
  -H "Authorization: Bearer {your_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "format": "png",
    "reverse": false
  }'

Upload and Process Image

POST /v1/upload

Remove background from an uploaded image file

Authorization

Bearer token required in Authorization header

Request Parameters

Content-Type: multipart/form-data

Parameter	Type	Required	Default	Description
image	File	Yes	-	Image file to process (JPEG, PNG)
format	String	No	png	Output format: 'png' or 'webp'
color	String	No		Valid RGB color: rgb(255, 0, 0)
blur	Boolean	No		Blur background instead of remove.
reverse	Boolean	No	false	If true, removes foreground instead of background

Response (200 OK)

{
  "image_url": "https://storage.example.com/u/{uuid}/bg/{id}.png",
  "size_mb": 0.45,
  "width": 1024,
  "height": 768
}

Example Request

curl -X POST http://api.removebg.sh/v1/upload \
  -H "Authorization: Bearer {your_token}" \
  -F "image=@image.jpg" \
  -F "format=png" \
  -F "reverse=false"

Generate Image Mask

POST /v1/mask

Generate background mask from the image provided via URL

Authorization

Bearer token required in Authorization header

Request Parameters

Parameter	Type	Required	Default	Description
image_url	String	Yes	-	URL of the image to process
format	String	No	png	Output format: 'png' or 'webp'
reverse	Boolean	No	false	If true, generates mask for foreground instead of background

Response (200 OK)

{
  "mask_url": "https://storage.example.com/u/{uuid}/bg/{id}_mask.png",
  "size_mb": 0.41,
  "width": 2048,
  "height": 2048
}

Example Request

curl -X POST http://api.removebg.sh/v1/mask \
  -H "Authorization: Bearer {your_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "format": "png",
    "reverse": false
  }'

Error Codes

401 Invalid or missing API token

403 Account inactive or monthly limit exceeded

400 Invalid request body or image format

413 Image file too large for plan limit

422 Invalid image format or corrupted image file

429 Rate limit exceeded

500 Internal server error