Skip to main content
POST
/
v3
/
cleanup
Cleanup
curl --request POST \
  --url https://api.novita.ai/v3/cleanup \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "extra": {
    "response_image_type": "<string>",
    "enterprise_plan": {
      "enabled": true
    }
  },
  "image_file": "<string>",
  "mask_file": "<string>"
}
'
{
  "image_file": "<string>",
  "image_type": "<string>"
}
Easily remove unwanted objects, defects, people, or text from your pictures in just seconds.

​
Request Headers

​
Content-Type
string
required
Enum: application/json
​
Authorization
string
required
Bearer authentication format, for example: Bearer {{API Key}}.

​
Request Body

​
extra
object
Optional extra parameters for the request.
​
image_file
string
required
The base64-encoded original image, with a maximum resolution of 16 megapixels and a maximum file size of 30 MB.
​
mask_file
string
required
The base64-encoded mask image, with a maximum resolution of 16 megapixels and a maximum file size of 30 MB.

​
Response

​
image_file
string
The Base64-encoded content of the returned image.
​
image_type
string
The returned image type.
Enum: png, webp, jpeg

​
Example

Cleanup allows you to easily remove unwanted objects, defects, people, or text from your pictures in just seconds. Try it in the playground. Request: 
curl --location --request POST 'https://api.novita.ai/v3/cleanup' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"image_file":"{{Base64 encoded image}}",
"mask_file":"{{Base64 encoded image}}"
}'
Response: 
{
    "image_file": "{{Base64 encoded image}}",
    "image_type": "png"
}
HTTP status codes in the 2xx range indicate that the request has been successfully accepted. A code of 400 means there is an error with the request parameters, while status codes in the 5xx range indicate internal server errors. You can retrieve the image URL in the image_file field of the response in base64 format. Response: 
{
    "image_file": "{{Base64 encoded image}}",
    "image_type": "png"
}
Last modified on June 10, 2026