[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Bria Product Shot](https://spiral.ai/integrations/codex/bria-product-shot)

# How to Use Bria Product Shot in Codex

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.

|  |  |
| --- | --- |
| Model | Bria Product Shot |
| Available through | fal |
| Category | Image |
| Price | $0.052 per generation. Billed on `num_results`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Bria Product Shot in Codex

- 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 Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Bria Product Shot**: One request; the result comes back by polling or a webhook.

```bash
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: Codex finds Bria Product Shot on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Bria Product Shot tools and prices

- [Bria Product Shot](https://spiral.ai/tools/fal/fal-ai/bria/product-shot) (fal): $0.052 per generation. Billed on `num_results`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| scene_description |  | — | Text description of the new scene or background for the provided product shot. Bria currently supports prompts in English only, excluding special characters. |
| ref_image_url |  |  | The URL of the reference image to be used for generating the new scene or background for the product shot. Use "" to leave empty.Either ref_image_url or scene_description has to be provided but not both. If both ref_image_url and ref_image_file are provided, ref_image_url will be used. Accepted formats are jpeg, jpg, png, webp. |
| optimize_description |  | true | Whether to optimize the scene description |
| num_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 |  | true | Whether to use the fast model |
| placement_type | original, automatic, manual_placement, 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. |

## What can you do with Bria Product Shot in Codex?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Bria Product Shot in other agents

- [Amp](https://spiral.ai/integrations/amp/bria-product-shot)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/bria-product-shot)
- [Claude](https://spiral.ai/integrations/claude-desktop/bria-product-shot)
- [Claude Code](https://spiral.ai/integrations/claude-code/bria-product-shot)
- [Cline](https://spiral.ai/integrations/cline/bria-product-shot)
- [Cursor](https://spiral.ai/integrations/cursor/bria-product-shot)
- [Devin](https://spiral.ai/integrations/devin/bria-product-shot)
- [dots](https://spiral.ai/integrations/dots/bria-product-shot)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/bria-product-shot)
- [Gemini](https://spiral.ai/integrations/gemini/bria-product-shot)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/bria-product-shot)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/bria-product-shot)
- [goose](https://spiral.ai/integrations/goose/bria-product-shot)
- [Grok](https://spiral.ai/integrations/grok/bria-product-shot)
- [Grok Build](https://spiral.ai/integrations/grok-build/bria-product-shot)
- [Hermes](https://spiral.ai/integrations/hermes/bria-product-shot)
- [Instinct](https://spiral.ai/integrations/instinct/bria-product-shot)
- [Manus](https://spiral.ai/integrations/manus/bria-product-shot)
- [Muse](https://spiral.ai/integrations/muse/bria-product-shot)
- [Muse Code](https://spiral.ai/integrations/muse-code/bria-product-shot)
- [n8n](https://spiral.ai/integrations/n8n/bria-product-shot)
- [Notion](https://spiral.ai/integrations/notion/bria-product-shot)
- [OpenClaw](https://spiral.ai/integrations/openclaw/bria-product-shot)
- [opencode](https://spiral.ai/integrations/opencode/bria-product-shot)
- [Perplexity](https://spiral.ai/integrations/perplexity/bria-product-shot)
- [Raycast](https://spiral.ai/integrations/raycast/bria-product-shot)
- [VS Code](https://spiral.ai/integrations/vscode/bria-product-shot)
- [Windsurf](https://spiral.ai/integrations/windsurf/bria-product-shot)
- [Zapier](https://spiral.ai/integrations/zapier/bria-product-shot)

## More Codex guides

- [Bria Product Holding](https://spiral.ai/integrations/codex/bria-product-holding)
- [Bria RMBG 2.0](https://spiral.ai/integrations/codex/bria-rmbg-2-0)
- [Bria Product Dimensions](https://spiral.ai/integrations/codex/bria-product-dimensions)
- [Bria Reimagine](https://spiral.ai/integrations/codex/bria-reimagine)
- [Bria Increase Resolution](https://spiral.ai/integrations/codex/bria-increase-resolution)
- [Bria Replace Background V2](https://spiral.ai/integrations/codex/bria-replace-background-v2)

## Questions about Bria Product Shot in Codex

**Can Codex use Bria Product Shot?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Bria Product Shot like any built-in tool.

**How much does Bria Product Shot cost in Codex?**

$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 Codex plan is separate.

**Do I need a fal account to use Bria Product Shot in Codex?**

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 Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Bria Product Shot runs?**

Bria Product Shot runs in the background. Codex 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.

