v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Image Editing

post/bria/image/edit/{action}

Path parameters

actionstring required

Editing action to perform. Supported values: erase, gen_fill, expand, enhance, increase_resolution, replace_background.

Headers

Content-Typestring

Must be application/json.

Request body

imagestring

Source image as a public URL or base64-encoded data URI. Accepted formats: JPEG, PNG, WebP. Maximum 12 MB.

maskstring

Mask image as a public URL or base64. White areas mark the region to edit; black areas are preserved. Required for erase, gen_fill, and expand actions.

promptstring

Text description of the desired edit. Required for gen_fill and replace_background actions.

num_resultsinteger

Number of result variants to generate. Default: 1.

syncboolean

When true, the response blocks until results are ready. When false (default), returns immediately with placeholder URLs that can be polled.

Response

Success

object required