---
title: "Lifestyle Shot"
method: POST
path: "/image/edit/product/lifestyle_shot"
tags: ["Products"]
---

# Lifestyle Shot

`POST /image/edit/product/lifestyle_shot`

## Request

- Base URL: `https://engine.prod.bria-api.com/v2`
- URL: `https://engine.prod.bria-api.com/v2/image/edit/product/lifestyle_shot`
- Auth: API key in header `api_token`

[**Try out this capability in Bria's sandbox**](https://platform.bria.ai/product-shot-editing/lifestyle-shot)

**Description**

Place your product in a new scene. Send one product photo and a `prompt` describing the scene, and the endpoint returns a new photo of the product in that scene.

The shot keeps the photo's framing and aspect ratio, at about one megapixel. There is no placement, aspect ratio or size to set.

By default the product is redrawn as part of the scene. When it must stay pixel-exact, for example to keep small label text, set `preserve_product` to `true`: the product from your photo is pasted back over the shot, and the shot comes back at your photo's resolution when the photo is larger, up to 25 megapixels. If the product moved in the shot, nothing is pasted back and the shot comes back as generated. `product_preserved` in the response says which happened.

Commercially safe: built on Bria's fully licensed models, cleared for enterprise use without copyright exposure.

**Example:** "Place this perfume bottle on a wet black slate ledge by a rain-streaked window at dusk, lit by a warm lamp from the left."

<table>
  <tr>
    <th style="text-align: center;">Product</th>
    <th style="text-align: center;">Result</th>
  </tr>
  <tr>
    <td align="center" style="vertical-align: middle;">
      <img src="https://labs-assets.bria.ai/api-examples/product-lifestyle-shot/product.jpg" width="250" style="border-radius: 8px;">
    </td>
    <td align="center" style="vertical-align: middle;">
      <img src="https://labs-assets.bria.ai/api-examples/product-lifestyle-shot/result.jpg" width="250" style="border-radius: 8px;">
    </td>
  </tr>
</table>

## Request body

- object
  - `image` string, required: The product photo. Publicly available URL or Base64-encoded. Accepted formats: JPEG, JPG, PNG, WEBP.
  - `prompt` string, required: The scene to place the product in, in free text: what it stands on, what surrounds it and how it is lit. Prompts in other languages are translated to English.
  - `preserve_product` boolean: Paste the product from your photo back over the shot, so its pixels are your photo's, and return the shot at your photo's resolution when the photo is larger, up to 25 megapixels. This parameter is optional. Skipped when the product moved in the shot, which then comes back as generated. `product_preserved` in the response says which happened.
  - `seed` integer: Seed for reproducible output. A random seed is used when omitted. This parameter is optional.
  - `sync` boolean: Specifies the response mode. This parameter is optional. - When `false` (default), the request is processed asynchronously: the API immediately returns a status URL to track progress. - When `true`, the request is processed synchronously: the API holds the connection open until the process is complete and then returns the final image URL in the response.
  - `webhook_url` string, uri: Optional URL for receiving the result via webhook when the async job completes. See [webhooks](/getting-started/async-requests#webhooks).
  - `output_type` 'png' | 'jpeg': The desired output format.
  - `prompt_content_moderation` boolean: If true, returns 422 when the prompt fails content moderation. This parameter is optional.
  - `visual_input_content_moderation` boolean: If true, returns 422 when the product photo fails content moderation. This parameter is optional.
  - `visual_output_content_moderation` boolean: If true, returns 422 on visual output moderation failure. This parameter is optional.

## Response `200`

Successful operation (Synchronous Success)

- object
  - `result` object, required
    - `image_url` string, required: URL of the lifestyle shot.
    - `seed` integer, required: The seed the shot was generated with.
    - `product_preserved` boolean, required: Whether the product from your photo was pasted back over the shot. `true` only when `preserve_product` was requested and the product kept its place in the shot.
  - `request_id` string, required

## Other responses

- `202`: Accepted (Asynchronous). Track progress and retrieve the final result using the [status endpoint](/status).
- `422`: Unprocessable Entity. Validation or content moderation failure, for example a blank `prompt`.
- `429`: Request limit exceeded.
- `5XX`: Internal server error.

## Changes

- **2026-11-17** `30913807d580`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bria-ai/apis/product-shot-api-reference/changes/image/edit/product/lifestyle_shot/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/30913807d580?raw)
