POST
/
v1
/
ai
/
beta
/
remove-background
Remove the background of an image
curl --request POST \
  --url https://api.freepik.com/v1/ai/beta/remove-background \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'x-freepik-api-key: <api-key>' \
  --data 'image_url=https://img.freepik.com/free-vector/cute-cat-sitting-cartoon-vector-icon-illustration-animal-nature-icon-concept-isolated-premium-vector-flat-cartoon-style_138676-4148.jpg?w=2000&t=st=1725353998~exp=1725357598~hmac=a17f90afeeff454b36c0715f84eed2b388cd9c4a7ce59fcdff075fa41770e469'
{
  "original": "https://api.freepik.com/v1/ai/beta/images/original/037ea4ea-e8ad84a8c7/thumbnail.jpg",
  "high_resolution": "https://api.freepik.com/v1/ai/beta/images/download/037ead-44cd8ad84a8c7/high.png",
  "preview": "https://api.freepik.com/v1/ai/beta/images/download/037ea4eacad84a8c7/preview.png",
  "url": "https://api.freepik.com/v1/ai/beta/images/download/037ea4ea-720d-411e8ad84a8c7/high.png"
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/x-www-form-urlencoded
​
image_url
string<uri>

The URL of the image whose background needs to be removed.

Example:

"https://img.freepik.com/free-vector/cute-cat-sitting-cartoon-vector-icon-illustration-animal-nature-icon-concept-isolated-premium-vector-flat-cartoon-style_138676-4148.jpg?w=2000&t=st=1725353998~exp=1725357598~hmac=a17f90afeeff454b36c0715f84eed2b388cd9c4a7ce59fcdff075fa41770e469"

Response

200 - application/json

Successful background removal.

​
original
string<uri>

URL of the original image.

​
high_resolution
string<uri>

URL of the high-resolution image with the background removed.

​
preview
string<uri>

URL of the preview version of the image.

​
url
string<uri>

Direct URL for downloading the high-resolution image.