---
title: "Image Editing"
method: POST
path: "/bria/image/edit/{action}"
---

# Image Editing

`POST /bria/image/edit/{action}`

## Path parameters

- `action` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `image` string — Source image as a public URL or base64-encoded data URI. Accepted formats: JPEG, PNG, WebP. Maximum 12 MB.
  - `mask` string — 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.
  - `prompt` string — Text description of the desired edit. Required for `gen_fill` and `replace_background` actions.
  - `num_results` integer — Number of result variants to generate. Default: 1.
  - `sync` boolean — When `true`, the response blocks until results are ready. When `false` (default), returns immediately with placeholder URLs that can be polled.

## Response `200`

Success

- object

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/revisions/0863102dbf34/schema)