Skip to content
Product Shot Editing
/
/
Apply Effects

Apply Effects

Request

Try out this capability in Bria's Automobile Playground

Description Adds visual overlays such as dust, snow, fog, light leaks, and lens flare to enhance the realism and atmosphere of a product image.

Each effect includes multiple variations to ensure visually unique results. Effects can be applied directly to the image or delivered as separate layers.

Headers
api_tokenstringrequired

API token associated with the organization

Bodyapplication/json
image_urlstring

The URL of the vehicle image. If both image_url and file are provided, image_url is used. Accepted formats are jpeg, jpg, png, webp.

filestring

The vehicle image in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp.

effectstring

The visual effect to apply to the image. Supported values are dust, snow, fog, light leaks, lens flare.

layersboolean

If true, returns only the effect layer. If false, returns the full image with the effect composited.

Default:false
seedinteger

Optional seed for generating consistent effect variations.

POST
/product/vehicle/apply_effect
curl -i -X POST \
  https://engine.prod.bria-api.com/v1/product/vehicle/apply_effect \
  -H 'Content-Type: application/json' \
  -H 'api_token: string' \
  -d '{
    "image_url": "https://example.com/vehicle.jpg",
    "effect": "fog",
    "layers": false,
    "seed": 42
  }'

Responses

Effect applied successfully.

Bodyapplication/json
urlstring

URL of the image with the effect applied.

layer_urlstring

URL of the effect layer. Only returned if layers=true.

seedinteger

Seed used for effect generation.

Response
{
  "url": "https://example.com/results/full_image_refined_1.png",
  "seed": 123
}