# Image Editing API Reference

Below you will find the technical specifications, request schemas, and response models for our endpoints. 

Choose an endpoint from the sidebar to view code samples and run test requests.



## Servers

```
https://engine.prod.bria-api.com/v2/image/edit
```

```
https://engine.prod.bria-api.com/v1
```

## Download OpenAPI description

 - [Image Editing API Reference](https://docs.bria.ai/_bundle/image-editing.yaml)

## v2 endpoints

 - [POST /image/edit](https://docs.bria.ai/image-editing/v2-endpoints/edit-image.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/fibo-image-edit) **Description** Powered by the **FIBO models family**, Bria's Image Editing by Text API equips b
 - [POST /structured_instruction/generate](https://docs.bria.ai/image-editing/v2-endpoints/generate-structured-instruction.md): **Description** Translates a user's text-based edit instruction and source image/mask into a detailed, machine-readable structured edit instruction in JSON format. This endpoint uses the state-of-the-
 - [POST /add_object_by_text](https://docs.bria.ai/image-editing/v2-endpoints/add-object-by-text.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/add-object-by-text) **Description** Insert new objects into an image using natural language to describe the objec
 - [POST /replace_object_by_text](https://docs.bria.ai/image-editing/v2-endpoints/replace-object-by-text.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/replace-object-by-text) **Description** Swap an existing object in an image with a new one using a natural langua
 - [POST /erase_by_text](https://docs.bria.ai/image-editing/v2-endpoints/erase-object-by-text.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/erase-object-by-text) **Description** Remove specific objects or unwanted elements from an image using natural la
 - [POST /blend](https://docs.bria.ai/image-editing/v2-endpoints/blend-image.md): **Description** Merge objects, apply textures, or rearrange items within an image using natural language. **Example:** Instruction: "Place the art on the shirt, keep the art exactly the same" <table>
 - [POST /reseason](https://docs.bria.ai/image-editing/v2-endpoints/reseason.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/image-reseason) **Description** Change the season or weather atmosphere of an image. **Example:** Season: "winter
 - [POST /rewrite_text](https://docs.bria.ai/image-editing/v2-endpoints/rewrite.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/rewrite) **Description** Change existing text within an image to new specific text. **Example:** new_text: "FIBO
 - [POST /sketch_to_colored_image](https://docs.bria.ai/image-editing/v2-endpoints/sketch-to-image.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/sketch-to-image) **Description** Convert a line drawing or sketch into a photorealistic colored image. <table> <t
 - [POST /restore](https://docs.bria.ai/image-editing/v2-endpoints/restore.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/restore-old-images) **Description** Renew old photos by removing noise, scratches, and blur. <table> <tr> <th sty
 - [POST /colorize](https://docs.bria.ai/image-editing/v2-endpoints/colorize.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/colorize) **Description** Add vivid colors to B&W photos or convert color to B&W. **Example:** style: "color_cont
 - [POST /restyle](https://docs.bria.ai/image-editing/v2-endpoints/restyle.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/restyle-image) **Description** Transform the artistic style of an image. Accepts either a preset Style ID or a cu
 - [POST /relight](https://docs.bria.ai/image-editing/v2-endpoints/relight.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/relight-image) **Description** Modify the lighting setup (direction and atmosphere) of an image. **Example:** * L
 - [POST /erase](https://docs.bria.ai/image-editing/v2-endpoints/erase.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/eraser) **Description** The *Eraser Route* enables the removal of elements or specific areas from a given image.
 - [POST /gen_fill](https://docs.bria.ai/image-editing/v2-endpoints/gen-fill.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/generative-fill) **Description** The *GenFill Route* enables the generation of objects by prompt in a specific re
 - [POST /remove_background](https://docs.bria.ai/image-editing/v2-endpoints/background-remove.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/remove-background) **Description** The *Remove BG* Route can be used to remove the background of an image. This r
 - [POST /replace_background](https://docs.bria.ai/image-editing/v2-endpoints/background-replace.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/replace-background) **Description** The *Replace BG Route* is used to replace the background of any image. We off
 - [POST /erase_foreground](https://docs.bria.ai/image-editing/v2-endpoints/erase-foreground.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/erase-foreground) **Description** The **Erase Foreground** endpoint removes the primary subject (foreground) from
 - [POST /blur_background](https://docs.bria.ai/image-editing/v2-endpoints/blur-bg.md): **Description** The *background/blur Route* is used to create a blur effect on the background of an image. **Content Moderation** This endpoint includes granular content moderation controls to ensure
 - [POST /expand](https://docs.bria.ai/image-editing/v2-endpoints/image-expansion.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/exapnd-image) **Description** The *Image Expension Route* can be used to expand an image, by utilizing generative
 - [POST /enhance](https://docs.bria.ai/image-editing/v2-endpoints/enhance.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/enhance-image) **Description** Regenerate an image with sharper textures and richer details while doubling resolu
 - [POST /increase_resolution](https://docs.bria.ai/image-editing/v2-endpoints/increase-resolution.md): [**Try out this capability in Bria's sandbox**](https://platform.bria.ai/image-editing/increase-resolution) **Description** The *Increase Resolution Route* is used to upscale the resolution of any ima
 - [POST /crop_foreground](https://docs.bria.ai/image-editing/v2-endpoints/crop.md): **Description** The Crop Route is used to remove the background from an image and crop tightly around the foreground or remaining region of interest. It supports both images with and without a backgro