Remove & Change Background

post https://api.picsart.io/tools/1.0/removebg

Discover the magic of seamless background removal with our removebg service, powered by cutting-edge AI technology. Our sophisticated algorithm effortlessly identifies and isolates the foreground, ensuring every detail from the delicate intricacies of jewelry to the finest strands of hair is captured with unparalleled precision. Designed to excel across a vast array of use cases, our service guarantees immaculate cutouts, whether for professional product photos, dynamic campaign graphics, or personal images meant for creative exploration. Experience flawless edges and exceptional detail preservation every time, elevating your images beyond the ordinary.

The recommended composition of an Image, in order to be optimally processed using the "removebg" service, is:

less busy background
high contrast (background/foreground)
background/foreground is distinguishable by naked eye

The foreground should be visually clear, high contrast with relatively sharp edges. The foreground should also be comparably big in the photo. Supported source image formats are JPG, PNG, TIFF, WEBP, and MPO.

Body Params

image

file

Source image file (binary). (If this parameter is present, the other image source parameters must be empty.)

image_url

uri

length between 1 and 2083

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image_id

string

Source image ID of an image previously uploaded to Picsart or result image ID from a different API. (If this parameter is present, the other image source parameters must be empty.)

output_type

string

Defaults to cutout

Select one of the two output options. If you submit a photo of a person, cutout returns the person as a sticker while mask returns a mask photo of the person.

bg_image

file | null

Source image file (binary). (If this parameter is present, the other image source parameters must be empty.) This only has an effect when output=cutout.

bg_image_url

string | null

Source image URL. (If this parameter is present, the other image source parameters must be empty.) If this has a value, the output value is dismissed.

bg_image_id

string | null

Source image ID of an image previously uploaded to Picsart or result image ID from a different API. (If this parameter is present, the other image source parameters must be empty.) See /upload method. If this has a value, the output value is dismissed.

bg_color

string | null

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). (If this parameter is present, the other bg_ parameters must be empty).

bg_blur

integer

0 to 100

Defaults to 0

Enter an integer value from 0 to +100.

bg_width

integer

Size, in pixels, for the width. If left blank, the background is left at its original width.

bg_height

integer

Size, in pixels, for the height. If left blank, the background is left at its original height.

scale

string

Defaults to fit

Fit is where the longer side (width/height) fits the background. Fill is where the shorter side fits the background. Fit is the default.

auto_center

boolean

Defaults to false

Automatically center the object. Works only, when output_type=cutout. We don't recommend using this flag when the object is visible only partially (e.g. half-cup or half-shoe is in the image).

stroke_size

integer | null

0 to 100

Defaults to 0

Add a solid stroke (border) around the cutout result. Works when output_type=cutout. Set 0 to remove. Takes values from 0 to 100.

stroke_color

string | null

Defaults to FFFFFF

Define the color of the stroke. Can be a hexcolor code (e.g., #82d5fa, #fff; with or without #) or a color name (e.g., blue; in English). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). Gets applied if the stroke_size is 1 and above.

stroke_opacity

integer | null

0 to 100

Defaults to 100

Define the opacity of the stroke added to the cutout result. Works when output_type=cutout and stroke_size is 1 and above. Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it transparent.

shadow

string

Defaults to disabled

A universal parameter to configure the shadow. The default value is "disabled" and it will make sure that the shadow is not rendered. The "custom" value allows to define custom position for the shadow, when this value is chosen, the shadow_offset_x and the shadow_offset_y will get applied. Other values are shadow directions with preset shadow setup (10px).

shadow_opacity

integer | null

0 to 100

Defaults to 20

Shadow Opacity. Works when shadow is enabled (a non-disabled value).

shadow_blur

integer | null

0 to 100

Defaults to 50

Shadow Blur. Works when shadow is enabled.

shadow_offset_x

integer | null

-100 to 100

Shadow Offset X. This is mandatory to specify when shadow=custom.

shadow_offset_y

integer | null

-100 to 100

Shadow Offset Y. This is mandatory to specify when shadow=custom.

format

string

Defaults to PNG

Optionally select one of the image formats (PNG is chosen if left blank). Options are as follows:

JPG
PNG
WEBP

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.picsart.io/tools/1.0/removebg \
3
     --header 'accept: application/json' \
4
     --header 'content-type: multipart/form-data' \
5
     --form output_type=cutout \
6
     --form bg_blur=0 \
7
     --form scale=fit \
8
     --form auto_center=false \
9
     --form stroke_size=0 \
10
     --form stroke_color=FFFFFF \
11
     --form stroke_opacity=100 \
12
     --form shadow=disabled \
13
     --form shadow_opacity=20 \
14
     --form shadow_blur=50 \
15
     --form format=PNG

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success.

400Bad Request

401Unauthorized

402Payment Required

403Forbidden

404Not Found

405Method Not Allowed

413Request Entity Too Large

415Unsupported Media Type

422Unprocessable Entity

429Too Many Requests

431Request Header Fields Too Large

500Internal Server Error

503Service Unavailable