[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Bria Product Holding](https://spiral.ai/integrations/opencode/bria-product-holding)

# How to Use Bria Product Holding in opencode

Bria Product Holding turns a person photo and product references into a shot of that person holding the product. Built on FIBO-Edit-1.5, it targets product placement while preserving the person's identity, clothing, pose, and background.

|  |  |
| --- | --- |
| Model | Bria Product Holding |
| Available through | fal |
| Category | Image |
| Price | $0.052 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Bria Product Holding in opencode

- Use Bria Product Holding with assets/person.jpg and assets/can.png. Replace the person's cup with the can, logo facing the camera, and save the result for the campaign page.
- Use Bria Product Holding with the person portrait and skincare bottle in public/images. Show the bottle in the person's right hand and preserve the clothing and background.
- Use Bria Product Holding with our existing campaign portrait and updated packaging reference. Create a holding shot for the redesign preview, keeping the person's identity and setting.
- Use Bria Product Holding with the portrait and the two product angles in assets/references. Create one holding scene with the product label facing the camera.
- Use Bria Product Holding with the person and product photos already used on the product page. Generate a holding image and add it to the local page preview for review.

## How to set up Bria Product Holding in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Holding**: 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": "bria/fibo-edit-1.5/product-holding",
    "input": {
      "person_image_url": "https://labs-assets.bria.ai/fal-examples/fibo-edit-1.5/product-holding/person.jpg",
      "product_image_urls": [
        "<product_image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: opencode finds Bria Product Holding on Spiral, shows the price and runs it.

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

## Bria Product Holding tools and prices

- [Bria Product Holding (FIBO-Edit-1.5)](https://spiral.ai/tools/fal/bria/fibo-edit-1.5/product-holding) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| instruction |  | — | Optional. A complete product-holding instruction already runs; this is appended to it. Use it for which hand, which way the label faces, or what must stay untouched. |
| aspect_ratio | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 | — | Output aspect ratio. Left unset, the output keeps the ratio of the person image. |
| seed |  | 5555 | Random seed. The same seed with the same inputs returns the same image. |

## What can you do with Bria Product Holding in opencode?

Create product-in-hand assets for storefronts and campaign pages from existing person and product photos. A coding agent can use project images to prepare holding shots and place the approved results into the site.

### Beverage campaign images

Replace a cup in an existing portrait with a referenced drink can, with its logo facing the camera.

### Skincare product portraits

Show a person holding a referenced skincare bottle while retaining the original clothing and setting.

### Packaging refresh previews

Use updated packaging references to preview a new product-in-hand shot with the same person and background.

### Product page lifestyle images

Turn an existing person photo and product reference into a holding shot for a product detail page.

### Carried product concepts

Create a carrying shot from a person photo and a reference image of the product to be carried.

### Product and packaging compositions

Use product and packaging references together to compose a single holding scene for review.

## Overview

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

## Bria Product Holding in other agents

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

## More opencode guides

- [Bria Product Dimensions](https://spiral.ai/integrations/opencode/bria-product-dimensions)
- [Bria Product Shot](https://spiral.ai/integrations/opencode/bria-product-shot)
- [Bria Increase Resolution](https://spiral.ai/integrations/opencode/bria-increase-resolution)
- [Bria RMBG 2.0](https://spiral.ai/integrations/opencode/bria-rmbg-2-0)
- [Bria HD](https://spiral.ai/integrations/opencode/bria-hd)
- [Bria Reimagine](https://spiral.ai/integrations/opencode/bria-reimagine)

## Questions about Bria Product Holding in opencode

**Can opencode use Bria Product Holding?**

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

**How much does Bria Product Holding cost in opencode?**

$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need a fal account to use Bria Product Holding in opencode?**

No. Spiral runs Bria Product Holding 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 Holding in opencode?**

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

**Does opencode wait while Bria Product Holding runs?**

Bria Product Holding runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.

**What is Bria Product Holding best used for?**

It makes product-in-hand images from an existing person photo and product references. Use it for holding or carrying shots that retain the original person and setting.

**Does Bria Product Holding keep the same person and background?**

The edit is designed to preserve identity, facial expression, clothing, pose, and background. That makes it suited to product placement within an existing shot.

**Can it preserve the product's branding?**

Bria describes the tool as preserving product geometry, colors, branding, and label text. Check those details against the reference before using a finished image.

**How much direction should I write?**

Keep it short and specific: name the hand, identify an object to replace, or say which way the label should face. Bria recommends steering only the detail you need rather than writing a full scene description.

**What are extra product references useful for?**

Use them to show another angle, packaging, or a companion item for the same holding scene. They do not request separate outputs for each product.

