POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 const axios = require('axios'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/bria-lifestyle-shot-by-text"; const data = { "fast": true, "image_url": "https://segmind-resources.s3.amazonaws.com/input/e7c734c4-9c4a-42f6-8df0-dc946b863191-45d0cf11ce028ea08ddf7aca1c2c38ad.jpeg", "scene_description": "A classroom setting with desks and books", "optimize_description": true, "exclude_elements": "no people", "placement_type": "automatic", "original_quality": false, "force_rmbg": false, "content_moderation": false }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


skustr ( default: 1 )

Optional SKU identifier for tracking products. Use unique codes for easier inventory management.


fastboolean ( default: true )

Fast mode balances speed and quality. Set to true for quick generation or false for detailed results.


image_urlstr ( default: https://segmind-resources.s3.amazonaws.com/input/e7c734c4-9c4a-42f6-8df0-dc946b863191-45d0cf11ce028ea08ddf7aca1c2c38ad.jpeg )

URL of the product image to blend in a scene. Use high-res images for quality outputs.


scene_descriptionstr ( default: A classroom setting with desks and books )

Describes the scene for the product. Use vivid settings like 'modern office desk' for best results.


optimize_descriptionboolean ( default: true )

Enables AI to enhance scene details. Set true to enhance scene realism or false to use the basic description.


exclude_elementsstr ( default: no people )

Specifies elements to exclude from the scene. Use 'no people' to remove human figures.


placement_typeenum:str ( default: automatic )

Determines product placement control. Choose 'original' for fixed spots or 'automatic' for varied angles.

Allowed values:


original_qualityboolean ( default: 1 )

Maintains image quality if true. Toggle on to preserve details in original placement mode.


aspect_ratioenum:str ( default: 1 )

Defines output image proportions. Set '16:9' for widescreen or '1:1' for a square frame.

Allowed values:


force_rmbgboolean ( default: 1 )

Forces removal of backgrounds. Use true to cleanly isolate product images from noisy backgrounds.


content_moderationboolean ( default: 1 )

Applies moderation to visuals. Enable for content checks before generation or disable for faster processing.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Bria Lifestyle Product Shot – AI Product Scene Generator

What is Bria Lifestyle Product Shot?

Bria Lifestyle Product Shot is a specialized AI model that transforms isolated product images into dynamic lifestyle scenes using text descriptions. Unlike traditional product photography that requires expensive studio setups, this model intelligently places your products into realistic environments described through simple text prompts. The AI handles background removal, scene generation, lighting consistency, and natural product placement automatically, making it ideal for eCommerce teams, marketing agencies, and content creators who need diverse product visuals at scale.

Key Features

Text-to-scene generation – Create lifestyle contexts from natural language descriptions
Automatic product placement – AI determines optimal positioning, angles, and sizing
Built-in background removal – Clean product isolation without manual editing
Flexible aspect ratios – Support for square, widescreen, and portrait formats
Quality-speed balance – Fast mode for rapid iteration or detailed mode for final assets
Content moderation – Optional safety checks for brand compliance

Best Use Cases

eCommerce Optimization: Generate multiple lifestyle shots for A/B testing product pages without photoshoots. Perfect for electronics, home goods, and fashion accessories in contextual settings.

Social Media Marketing: Create Instagram-ready product content showing items in aspirational environments like "cozy coffee shop" or "minimalist workspace."

Catalog Diversification: Transform single product shots into varied lifestyle imagery for seasonal campaigns, demographic targeting, or regional preferences.

Rapid Prototyping: Test visual concepts before committing to expensive photography sessions.

Prompt Tips and Output Quality

Write specific, vivid scene descriptions like "modern kitchen counter with natural sunlight and fresh ingredients" rather than generic terms like "kitchen scene." The model responds well to environmental details, lighting conditions, and mood descriptors.

Use the exclude_elements parameter strategically – "no people, no text, no logos" helps maintain focus on your product. Enable optimize_description for enhanced scene realism, as the AI will expand your prompt with contextually relevant details.

For placement_type, choose "automatic" for varied angles and dynamic positioning, or "original" when you need consistent product orientation across multiple scenes. The fast mode works well for initial concepts, while disabled fast mode delivers higher detail for final marketing assets.

FAQs

How is this different from generic AI image generators?
Unlike general AI models, Bria Lifestyle Product Shot is specifically trained for product placement, ensuring realistic lighting, shadows, and scale consistency between your product and the generated scene.

What image formats and resolutions work best?
High-resolution PNG or JPG images with clear product visibility produce optimal results. The model handles background removal automatically, so studio-quality cutouts aren't required.

Can I control exactly where my product appears?
Yes, through placement_type parameters. "Automatic" lets AI choose optimal positioning, while "manual_placement" and "custom_coordinates" offer precise control.

Is the model suitable for all product categories?
The model excels with physical products like electronics, home goods, beauty items, and accessories. Very small or highly reflective products may require specific prompt adjustments.

What aspect ratios should I use for different platforms?
Use 1:1 for Instagram posts, 16:9 for website banners, 9:16 for mobile stories, and 4:5 for Facebook feed optimization.

How does content moderation affect generation speed?
Enabling content moderation adds 2-3 seconds but ensures brand-safe outputs, recommended for client-facing or regulated industry applications.