Prompt-based image editing

Prompt-based editing lets you modify a specific part of an image by describing the change you want to see. The API uses a context image and generates a new version based on your instruction.

Basic example

Let's us try to remove a blue car from below photo.

{
  "background": {
    "generate": {
      "description": "remove a blue car",
      "model_type": "gemini-3-pro-image-preview",
      "adapter_type": "img2img",
      "context_images": [
        "https://s3.eu-central-1.amazonaws.com/deep-image.ai/api-examples/gitbook1.jpg"
      ]
    }
  },
  "width": 1344,
  "height": 768
}

And the result is

Parameters of background generate section

Parameter	Description
description	Text prompt describing the edit you want to apply.
model_type	Model used for editing. Example: gemini-3-pro-image-preview. Other models
adapter_type	Adapter that defines the editing mode. Use img2img for editing based on an existing image.
context_images	Array of URLs to source images used as context for the edit.
width	Target width of the output image.
height	Target height of the output image.

Notes

• Use clear and specific prompts (e.g., “remove a blue car”, “replace sky with sunset”).

• The output size is controlled by width and height.

• context_images must be publicly accessible URLs.

Example prompt variations

Remove object

{
  "background": {
    "generate": {
      "description": "remove a blue car",
      "model_type": "gemini-3-pro-image-preview",
      "adapter_type": "img2img",
      "context_images": [
        "https://s3.eu-central-1.amazonaws.com/deep-image.ai/api-examples/gitbook1.jpg"
      ]
    }
  },
  "width": 1344,
  "height": 768
}

Change background

Add detail