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.

Security
api_token
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
# The Python SDK covers v2 endpoints; call this v1 endpoint over HTTP.
import os

import httpx

response = httpx.post(
    "https://engine.prod.bria-api.com/v1/product/vehicle/apply_effect",
    headers={"api_token": os.environ["BRIA_API_TOKEN"]},
    json={
        "image_url": "https://example.com/vehicle.jpg",
        "effect": "fog",
        "layers": False,
        "seed": 42,
    },
    timeout=120,
)
response.raise_for_status()
print(response.json())

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
}