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

# Tires Refinement

`POST /product/vehicle/refine_tires`

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

## Headers

- `api_token` string, required

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

---

[API](https://skmtc.net/bria-ai/apis/product-shot-api-reference.md) · [All operations](https://skmtc.net/bria-ai/apis/product-shot-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bria-ai/product-shot-api-reference/revisions/02853e3865f7/schema)
