Background Removal API Documentation

Complete guide to integrating the NOBG.LINK background removal API into your applications with code examples and best practices.

Getting Started

The NoBG.link API provides fast and accurate background removal powered by state-of-the-art AI models. Get started in minutes with our simple REST API.

curl -X POST https://www.nobg.link/api/remove-background \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "modelType=portrait" \
  -F "format=png" \
  -o result.png

Authentication

All API requests require authentication using an API key sent in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API Endpoints

AI Models

Choose the best model for your use case:

-F "modelType=portrait"

-F "model=universal"

-F "model=fast"

-F "model=birefnet"

-F "model=bria"

Parameters

Error Handling

The API uses conventional HTTP response codes:

{
  "error": "invalid_request",
  "message": "Missing required parameter: image"
}

{
  "error": "unauthorized",
  "message": "Invalid API key"
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Try again in 60 seconds",
  "retry_after": 60
}

SDKs & Libraries

Official SDKs and community libraries for popular programming languages:

npm install removebg-api

import RemoveBG from 'removebg-api';
const api = new RemoveBG('YOUR_API_KEY');
const result = await api.remove('image.jpg');

pip install removebg-python

from removebg import RemoveBG
api = RemoveBG('YOUR_API_KEY')
result = api.remove('image.jpg')

composer require removebg/php-sdk

use RemoveBG\RemoveBG;
$api = new RemoveBG('YOUR_API_KEY');
$result = $api->remove('image.jpg');

gem install removebg

require 'removebg'
api = RemoveBG::API.new('YOUR_API_KEY')
result = api.remove('image.jpg')