Skip to content
Product Shot Editing
/
/
Harmonization

Harmonization

Request

Try out this capability in Bria's Automobile Playground

Description Applies predefined lighting and tone presets to match the product image with a desired environmental context.

Available presets include hot-day, cold-day, hot-night, and cold-night. These harmonization styles help unify the subject with its background for a consistent and visually appealing result.

Security
api_token
Bodyapplication/json
image_urlstring

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

filestring

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

presetstring

The preset to apply. Supported values are warm-day, cold-day, warm-night, cold-night.

POST
/product/vehicle/harmonize
# 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/harmonize",
    headers={"api_token": os.environ["BRIA_API_TOKEN"]},
    json={
        "image_url": "https://example.com/images/car_side_view.png",
        "preset": "cold-day",
    },
    timeout=120,
)
response.raise_for_status()
print(response.json())

Responses

Preset applied successfully.

Bodyapplication/json
urlstring

URL of the image with the preset applied.

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