How to Use Bria Product Shot in Windsurf
Bria Product Shot turns an existing product photo into lifestyle imagery for store pages and campaigns. Describe a new setting or supply a scene reference while retaining the product's appearance.
Prompts to try with Bria Product Shot in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Bria Product Shot with the coffee grinder photo in the project's assets. Create a 1000 by 1000 pixel scene on an oak kitchen counter with soft window light from the left, then show it in the product page preview.
Use Bria Product Shot with the skincare bottle photo in this project. Create a pale stone bathroom setting with a softly blurred tiled wall, preserving the product's original position and size.
Use Bria Product Shot with the sneaker photo in the product assets. Create separate 1000 by 1000 pixel scenes on concrete, wood, and pale fabric, keeping the lighting description consistent for comparison.
Use Bria Product Shot with the project's mug photo and campaign scene reference. Generate a lifestyle image guided by that reference and place it in a local preview beside the current image.
Use Bria Product Shot with the candle photo in the assets folder. Create a 1000 by 1000 pixel scene on a dark walnut table with warm light from the right, then preview it in the email template.
How to set up Bria Product Shot in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Bria Product Shot
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "fal", "model": "fal-ai/bria/product-shot", "input": { "image_url": "https://storage.googleapis.com/falserverless/bria/bria_product_fg.jpg" } }'
Then paste one of the prompts above: Windsurf finds Bria Product Shot on Spiral, shows the price and runs it.
Bria Product Shot providers and prices
Spiral runs Bria Product Shot through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Bria Product Shot works from your image URL. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Optimize description | on or off | on | Whether to optimize the scene description |
| Number of results | 1 to 4 | 1 | The number of lifestyle product shots you would like to generate. You will get num_results x 10 results when placement_type=automatic and according to the number of required placements x num_results if placement_type=manual_placement. |
| Fast | on or off | on | Whether to use the fast model |
| Placement type | original, automatic, manual_placement, or manual_padding | manual_placement | This parameter allows you to control the positioning of the product in the image. Choosing 'original' will preserve the original position of the product in the image. Choosing 'automatic' will generate results with the 10 recommended positions for the product. Choosing 'manual_placement' will allow you to select predefined positions (using the parameter 'manual_placement_selection'). Selecting 'manual_padding' will allow you to control the position and size of the image by defining the desired padding in pixels around the product. |
| Original quality | on or off | off | This flag is only relevant when placement_type=original. If true, the output image retains the original input image's size; otherwise, the image is scaled to 1 megapixel (1MP) while preserving its aspect ratio. |
| Manual placement selection | upper_left, upper_right, bottom_left, bottom_right, right_center, left_center, upper_center, bottom_center and 2 more | bottom_center | If you've selected placement_type=manual_placement, you should use this parameter to specify which placements/positions you would like to use from the list. You can select more than one placement in one request. |
Every API field of Bria Product Shot is on its tool page: open its card above.
What can you do with Bria Product Shot in Windsurf?
Create product imagery that fits the store pages you are building. Use the project's product photos and design brief to generate scenes, then review them in the actual layouts.
Product page lifestyle images
Start with a product photo and create a setting that shows where it belongs, such as a coffee grinder on a kitchen counter.
Seasonal campaign scenes
Use the same product photo to explore summer patio, autumn tabletop, or winter mantel settings for a seasonal campaign.
Advertising background tests
Compare a product against stone, wood, and fabric settings while keeping the scene brief otherwise consistent.
Reference-led campaign imagery
Pair a product photo with a scene reference to explore backgrounds that follow an established campaign direction.
Email campaign product images
Create a lifestyle image from an existing product photo, then add the email headline and offer in your layout tool.
Social product posts
Turn a product photo into a square lifestyle image, targeting 1000 by 1000 pixels for the generated asset.
Creative direction previews
Explore different surfaces, surroundings, and lighting descriptions around the same product before choosing a campaign direction.
More on Bria Product Shot and Windsurf
Overview
Bria Product Shot in other agents
Questions about Bria Product Shot in Windsurf
Can Windsurf use Bria Product Shot?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Bria Product Shot like any built-in tool.
How much does Bria Product Shot cost in Windsurf?
$0.052 per generation. Billed on `num_results`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need a fal account to use Bria Product Shot in Windsurf?
No. Spiral runs Bria Product Shot on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Bria Product Shot in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Bria Product Shot runs?
Bria Product Shot runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.
What is Bria Product Shot useful for?
Use it to show an existing product in new lifestyle settings for store pages, campaign images, and creative tests. It builds the scene around the product's existing appearance.
How should I write a scene description?
Specify the surface, surroundings, materials, and light direction. For example: a pale stone bathroom counter beside a window, with soft morning light from the left.
Which languages does Bria Product Shot support?
Write scene descriptions in English and avoid special characters. Translate a non-English brief before using it as the scene description.
What output resolution should I target?
Aim for roughly one megapixel when specifying the output dimensions. A 1000 by 1000 pixel square meets that recommendation; one megapixel is a recommended working size, not a documented maximum.
What source photo problems should I fix first?
Choose a photo with the whole product visible and sharp edges. Blurred handles, fine fibers, and glass rims deserve particular attention before generation.
Start using Bria Product Shot in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


