# Overview Bria’s Product Shot Editing APIs gives builders powerful tools to streamline visual content creation — enabling developers to automate and enhance product shots with more control, flexibility, and realism. Core capabilities include product cutouts, customizable backgrounds for professional packshots, consistent shadow rendering, and AI-powered lifestyle shots using both text and reference images. **Automotive Product Shot Editing** As a first step, we’ve introduced dedicated support for automotive workflows — adding vehicle-specific features such as realistic reflection generation, tire and wheel refinement, environmental effects (e.g., fog, dust, snow), and harmonization presets. These capabilities are designed to reduce manual work and help teams create high-quality vehicle visuals faster, with more creative control. Support for additional product categories is coming soon. ## Servers ``` https://engine.prod.bria-api.com/v1 ``` ## Download OpenAPI description [Overview](https://docs.bria.ai/_spec/product-shot-editing.yaml) ## Product Endpoints ### Product Cutout - [POST /product/cutout](https://docs.bria.ai/product-shot-editing/product-endpoints/product-cutout.md): This capability allows you to create a precise cutout of a product from any given image. This feature is especially valuable for eCommerce platforms and applications, serving as a fundamental building block for crafting a user-friendly interface. This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content or if the modified output would contain inappropriate content. ### Product Packshot - [POST /product/packshot](https://docs.bria.ai/product-shot-editing/product-endpoints/product-packshot.md): The Product Pack Shot feature is designed to create professional standard pack shots. The output is a 2000x2000 px image, with the product size and location according to best practices. This feature can allow users to take any photo of a product and transform it into a professional pack shot, placing the product on a clean, seamless background, typically white but customizable to any color. This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content or if the modified output would contain inappropriate content. ### Product Shadow - [POST /product/shadow](https://docs.bria.ai/product-shot-editing/product-endpoints/product-shadow.md): The Product Shadow API allows you to add consistent and customizable shadow to a product cutout. This feature is designed to work in combination with other capabilities like product cutout, product packshot and product lifestyle shots, enhancing the visual appeal of e-commerce and product imagery. If the product image isn't a product cutout, you should use the product cutout API first. The product shadow API accepts a product cutout as input. Once you have a product cutout with a shadow, you can use it in product packshot or product lifestyle shot APIs, where needed. This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content or if the modified output would contain inappropriate content. ### Lifestyle Product Shot by Text - [POST /product/lifestyle_shot_by_text](https://docs.bria.ai/product-shot-editing/product-endpoints/product-lifestyle-shot-by-text.md): Creates enriched product shots by placing them in various environments using textual descriptions. In addition, you can adjust the background of the product by replacing it with a solid color. To do this, specify a hex color code (e.g., #FF5733) in the . This feature is only available when generating a single result (). 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. ### Lifestyle Product Shot by Image - [POST /product/lifestyle_shot_by_image](https://docs.bria.ai/product-shot-editing/product-endpoints/product-lifestyle-shot-by-image.md): Generates enriched product shots by placing them in visually compelling environments, guided by a reference image. 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. ### Consistent Product Shots (Coming Soon) - [POST /products/consistent_shots](https://docs.bria.ai/product-shot-editing/product-endpoints/consistent-product-shots.md): This feature allows users to create consistent product shots by providing either a textual description of a scene or an image, along with a group of product images. The resulting consistent product shots are ideal for use on social media, eCommerce websites, product catalogs, and other marketing materials, ensuring a uniform and professional appearance across all platforms. ### Contextual Keyword Extraction (Coming Soon) - [POST /product/contextual_keyword_extraction](https://docs.bria.ai/product-shot-editing/product-endpoints/contextual-keyword-extraction.md): This feature allows users to extract relevant keywords from an image and its context, focusing on the primary product rather than secondary elements. This capability enhances search optimization in eCommerce by ensuring that the keywords accurately represent the product being sold. It can be particularly useful for improving product searchability on eCommerce websites, enhancing SEO for product listings, automating content management, and optimizing social media marketing efforts. ## 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.