Skip to content

Tires Refinement

Request

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.

Headers
api_tokenstringrequired

API token associated with the organization

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
curl -i -X POST \
  https://engine.prod.bria-api.com/v1/product/vehicle/refine_tires \
  -H 'Content-Type: application/json' \
  -H 'api_token: string' \
  -d '{
    "image_url": "https://example.com/car.jpg",
    "masks": {
      "tires": "https://example.com/masks/tires.png"
    },
    "layers": true
  }'

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 }