# Embed products into a scene

[**Try out this capability in Bria's sandbox**](https://platform.bria.ai/product-shot-editing/product-embedding)
**Description**
Integrate and embed one or more products into a predefined scene at precise user-defined coordinates.
This endpoint ensures the product matches the scene's lighting, perspective, and aesthetics.
**Note on Product Cutout & Scaling:** Please use Product Cutput endpoint first, to create a presice cutout of your product. **Crucially, the provided `coordinates` (x, y, width, height) are applied to the resulting tight cutout of the product, not the original source image.** To avoid stretching or distortion, developers should ensure the requested width/height matches the aspect ratio of the actual product object rather than the original canvas.

Endpoint: POST /image/edit/product/integrate
Security: api_token

## Request fields (application/json):

  - `scene` (string, required)
    Publicly available URL or Base64-encoded image of the scene where the product will be embedded. Accepted formats are jpeg, jpg, png, webp.

  - `products` (array, required)
    An array where each object defines a product to be embedded and its specific placement within the scene. Supports 1 to N products.

  - `products.image` (string, required)
    Publicly available URL or Base64-encoded image of the product. Accepted formats are jpeg, jpg, png, webp.
**Note:**
- If the image contains an alpha channel, no cutout is applied.
- If the image does not contain an alpha channel, automatic product cutout is applied.

  - `products.coordinates` (object, required)
    An object specifying the exact placement and scaling of the **cutout product** within the scene.

  - `products.coordinates.x` (integer, required)
    X-coordinate of the cutout product's top-left corner relative to the scene image.

  - `products.coordinates.y` (integer, required)
    Y-coordinate of the cutout product's top-left corner relative to the scene image.

  - `products.coordinates.width` (integer, required)
    Target width for the tightly cropped product. Ensure this matches the product's aspect ratio to prevent distortion.

  - `products.coordinates.height` (integer, required)
    Target height for the tightly cropped product.

  - `seed` (integer)
    Seed for deterministic generation. Uses a random seed if omitted.

  - `visual_input_content_moderation` (boolean)
    If true, returns 422 on visual input moderation failure for scene or product.

  - `visual_output_content_moderation` (boolean)
    If true, returns 422 on visual output moderation failure.