---
title: "Tires Refinement"
method: POST
path: "/product/vehicle/refine_tires"
tags: ["Automotive"]
---

# Tires Refinement

`POST /product/vehicle/refine_tires`

## Request

- Base URL: `https://engine.prod.bria-api.com/v1`
- URL: `https://engine.prod.bria-api.com/v1/product/vehicle/refine_tires`
- Auth: API key in header `api_token`

[**Try out this capability in Bria's Automobile Playground**](https://console.bria.ai/automotive)

**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.

## Request body

- object
  - `image_url` string: 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.
  - `file` string: The image file in base64 format. Used only if image_url is not provided. Accepted formats are jpeg, jpg, png, webp.
  - `masks` object: An object containing the URLs of binary masks for the wheels and hubcaps.
    - `tires` string: Binary mask URL for the tires.
  - `layers` boolean: If true, returns only the refined wheels layer. If false, returns the full image with refined wheels.

## Response `200`

Wheel refinement successfully applied.

- object
  - `url` string: URL of the full image with refined wheels.
  - `layer_url` string: URL of the separate refined wheels layer. Only returned if layers=true.
  - `seed` integer: Optional seed used for generation.

## Other responses

- `400`: Bad request. Missing or invalid parameters.
- `401`: Unauthorized. Invalid API key or authentication token.
- `403`: Forbidden
- `404`: Not found. Image could not be found at the provided URL.
- `413`: Payload too large. Image file size exceeds the 12MB limit.
- `415`: Unsupported media type. Supported types are jpeg, jpg, png, webp.
- `422`: Unprocessable Content
- `429`: Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later.
- `460`: Failed to download image.
- `500`: Internal server error. An error occurred on the server.

## Changes

- **2026-09-28** `ac924fd17279`: 1 warning, 2 info
  - deleted the `header` request parameter `api_token`
  - api tag `Automotive` added
  - api tag `Automotive Endpoints` removed

[Operation history](https://skmtc.dev/bria-ai/apis/product-shot-api-reference/changes/product/vehicle/refine_tires/post.md)

---

[API](https://skmtc.dev/bria-ai/apis/product-shot-api-reference.md) · [All operations](https://skmtc.dev/bria-ai/apis/product-shot-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/bria-ai/apis/product-shot-api-reference/revisions/ac924fd17279?raw)