Skip to content
Product Shot Editing
/
/
Tires Refinement

Tires Refinement

Request

Try out this capability in Bria's Automobile Playground

Description Enhances the appearance of the vehicle tires by adding realistic textures that match specific surfaces - snow, mud, grass.

This endpoint accepts a binary mask of all tires and returns the image with refined tires. You can optionally receive the refined wheels as a separate layer.

Security
api_token
Bodyapplication/json
image_urlstring

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

filestring

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

masksobject

An object containing the URLs of binary masks for the wheels and hubcaps.

layersboolean

If true, returns only the refined wheels layer. If false, returns the full image with refined wheels.

POST
/product/vehicle/refine_tires
# 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/refine_tires",
    headers={"api_token": os.environ["BRIA_API_TOKEN"]},
    json={
        "image_url": "https://example.com/car.jpg",
        "masks": {
            "tires": "https://example.com/masks/tires.png",
        },
        "layers": True,
    },
    timeout=120,
)
response.raise_for_status()
print(response.json())

Responses

Wheel refinement successfully applied.

Bodyapplication/json
urlstring

URL of the full image with refined wheels.

layer_urlstring

URL of the separate refined wheels layer. Only returned if layers=true.

seedinteger

Optional seed used for generation.

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