Background removal and generation

Use background.remove to cut out the main subject.

You can keep transparency, apply a flat color, replace the background, or generate a new one.

Background removal

{
    "background": {
        "remove": "auto",
        "color": "#FFFFFF"
    }
}

Parameters

Parameter	Description
remove	Controls the background removal mode. Supported values are auto, v2, human, item, and generative.
prompt	Text instruction used with remove: "generative". Describe what should stay in the foreground.
color	Controls the output background color. Use auto, a hex color like #FFFFFF, or transparent.
replace	URL of a background image for simple replacement. This does not generate new shadows or reflections.

auto is the default mode.

Use human for portraits.

Use item for products and objects.

Use generative when the image has multiple relevant foreground elements and you want the prompt to guide what stays.

Let's check some examples.

Click the result image to compare it with the source.

transparent

{
    "url": "https://deep-image.ai/api-example.png",
    "background": {
        "remove": "auto",
        "color": "transparent"
    }
}

white

{
    "url": "https://deep-image.ai/api-example.png",
    "background": {
        "remove": "item",
        "color": "#FFFFFF"
    }
}

replace

{
    "url": "https://deep-image.ai/api-example.png",
    "background": {
        "remove": "auto",
        "replace": "https://images.pexels.com/photos/628281/pexels-photo-628281.jpeg?auto=compress&cs=tinysrgb&w=1260&h=750&dpr=1"
    }
}

Prompt-based background removal

Use prompt-based removal when auto keeps too much, removes too much, or misses related foreground objects.

Keep the prompt short and focused on what should remain.

{
    "background": {
        "remove": "generative",
        "prompt": "keep relevant foreground, keep relevant objects"
    }
}

You can combine this with color or replace when you do not want a transparent result.

For image preparation tips, see Remove BG recommendation.

Item cropping

You can combine background removal, padding, and item crop to center a subject inside a fixed canvas.

{
    "url": "https://deep-image.ai/api-example2.jpg",
    "width": 1000,
    "height": 1000,
    "fit": {
         "crop": "item"
    },
    "background": {
        "remove": "auto",
        "color": "#FFFFFF"
    },
    "padding": 100
}

Result

Background generation

Background generation improves product photos without a manual photo shoot.

It removes the original background, places the subject on the canvas, and generates a new scene around it.

Parameters

Parameter	Description
description	Text prompt describing the scene.
item_area_percentage	Float from 0 to 1 that controls how much of the final image the item occupies. 0.85 means 85%.
sample_num	Random seed for the generated image. If you omit it, results vary between runs.
color	Converts the generated background to black and white, then tints it with the given RGB array. Example: [255,255,255].
background_url	URL of an image blended with the generated background for more consistent outputs.

{
    "url": "https://deep-image.ai/api-example.png",
    "background": {
        "generate": {
            "description": "item standing on sand with beach in background",
            "item_area_percentage": 0.65,
            "sample_num": 12663
        }
    }
}

Without sample_num:

{
    "url": "https://deep-image.ai/api-example.png",
    "background": {
        "generate": {
            "description": "item standing on sand with beach in background",
            "item_area_percentage": 0.65
        }
    }
}

You can also set the output size:

{
    "url": "https://deep-image.ai/api-example.png",
    "width": 1000,
    "height": 1000,
    "background": {
        "generate": {
            "description": "item standing on sand with beach in background",
            "item_area_percentage": 0.65
        }
    }
}

When specifying a color:

{
    "url": "https://deep-image.ai/api-example.png",
    "width": 1000,
    "height": 1000,
    "background": {
        "generate": {
            "description": "item positioned on plain white background",
            "item_area_percentage": 0.65,
            "color": [217,179,190]
        }
    }
}