# Automotive Endpoints

## Vehicle Shot by text

 - [POST /product/vehicle/shot_by_text](https://docs.bria.ai/product-shot-editing/automotive-endpoints/vehicle-shot-by-text.md): Creates enriched automotive product shots by placing vehicles in realistic environments using textual descriptions.  

This endpoint includes vehicle-specific enhancements that adapt the background scene to match automotive contexts, specifically - snow, sand, and grass. It embeds the vehicle into the environment for a natural, grounded appearance.  

This endpoint also allows adjusting the position of the product and the size of the final product shot. This enables the creation of new and unique variations of your original product image while maintaining control over layout and format.

To control product positioning and shot dimensions, use the  parameter, which offers several control modes:

- : preserves the original position and size of the product from the input image.
- : generates results with 7 recommended placements, while the shot_size is defined by the 'shot_size' parameter.
- : allows choosing from predefined positions using . The shot_size is defined by the 'shot_size' parameter.
- : provides full control over the product's size and location using  and . The shot_size is defined by the 'shot_size' parameter.
- : lets you define padding in pixels around the product to control both size and placement.
- : centers the product and resizes the canvas automatically to match the specified .

The parameters used for positioning and sizing depend on the selected . Refer to the documentation for each mode to understand the supported fields and behaviors.

This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content, and filters out unsafe modified images — the first blocked input image will fail the entire request.  

## Vehicle Shot by Image (Coming soon)

 - [POST /product/vehicle/shot_by_image](https://docs.bria.ai/product-shot-editing/automotive-endpoints/vehicle-shot-by-image.md): Coming soon


## Segmentation

 - [POST /product/vehicle/segment](https://docs.bria.ai/product-shot-editing/automotive-endpoints/vehicle-segmentation.md): Generates segmentation masks for specific vehicle parts from an input image, enabling further enhancements such as reflection generation or wheel refinement.  

This endpoint returns separate binary masks for each segmented region, including windows, wheels, and body parts. If a specific part is not detected in the image, it will be returned with an empty URL.  

The API supports input via image URL or base64-encoded image file, and also includes optional content moderation.

## Reflections

 - [POST /product/vehicle/generate_reflections](https://docs.bria.ai/product-shot-editing/automotive-endpoints/vehicle-generate-reflections.md): Generates realistic reflections on relevant surfaces of a product image, such as glass, metal, or glossy materials.

Reflection masks can be provided manually or generated automatically using our segmentation tools.

The output includes an updated image with applied reflections and optional reflection layers per region.

## Tires Refinement

 - [POST /product/vehicle/refine_tires](https://docs.bria.ai/product-shot-editing/automotive-endpoints/vehicle-refine-tires.md): 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.  

## Apply Effects

 - [POST /product/vehicle/apply_effect](https://docs.bria.ai/product-shot-editing/automotive-endpoints/vehicle-apply-effect.md): Adds visual overlays such as dust, snow, fog, light leaks, and lens flare to enhance the realism and atmosphere of a product image.

Each effect includes multiple variations to ensure visually unique results. Effects can be applied directly to the image or delivered as separate layers.

## Harmonization

 - [POST /product/vehicle/harmonize](https://docs.bria.ai/product-shot-editing/automotive-endpoints/vehicle-harmonize.md): 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.