edit

Media · Image · Generative fill / inpaint with prompt

Fill a masked region of an image with AI-generated content described by prompt. Requires a mask (mask_url or mask_base64) marking WHERE to fill. Use this when you have a specific region to replace; for removing an object by description (no mask) use magicInpaint; to extend the image past its edges use imageOutpainting. Async — returns a task_id (auto-polled).

post/api/v1/tools/generative-fill

Request

  • Base URL
    https://api.simplified.com
  • Auth
    API key in header Authorization

Request body

image_urlstring required

URL of the source image.

promptstring required

Text description of what to generate in the masked area.

mask_urlstring

URL of the mask image (white = fill area).

mask_base64string

Base64-encoded mask image (alternative to mask_url).

negative_promptstring

What to avoid in the generated content.

countinteger

Number of variations to generate.

Response

Async task queued.

task_idstring

Poll GET /api/v1/tasks/{task_id} until SUCCESS or FAILURE.

Changes

No recorded changes to this operation across all 1 revision of this API.