[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Fibo BBQ Preview](https://spiral.ai/integrations/windsurf/fibo-bbq-preview)

# How to Use Fibo BBQ Preview in Windsurf

Fibo BBQ Preview suits image briefs where object placement and color need explicit control. Compared with FIBO, it adds numeric bounding boxes and RGB colors to structured scene descriptions.

|  |  |
| --- | --- |
| Model | Fibo BBQ Preview |
| 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 Fibo BBQ Preview in Windsurf

- Use Fibo BBQ Preview to create a wide image for our homepage. Read the hero component, place a ceramic vase opposite the headline, and leave the headline area empty.
- Use Fibo BBQ Preview to make a square still life of three geometric objects. Take their RGB colors from our theme file and give each object a separate bounding box.
- Use Fibo BBQ Preview to test three positions for a desk lamp in our landing page image. Keep the seed and all other scene details fixed; save a comparison.
- Use Fibo BBQ Preview to create a product scene concept from our design brief. Specify the bottle, pedestal, background, lighting, and camera angle separately.
- Use Fibo BBQ Preview to compare two chair colors from our design tokens. Keep the seed and composition fixed, then show both images beside the relevant page component.

## How to set up Fibo BBQ Preview in Windsurf

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

### Use Spiral's MCP server

1. **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:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **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.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 Fibo BBQ Preview**: 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-bbq-preview/generate",
    "input": {
      "prompt": "A hyper-detailed, ultra-fluffy owl sitting in the trees at night, looking directly at the camera with wide, adorable, expressive eyes. Its feathers are soft and…"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Fibo BBQ Preview on Spiral, shows the price and runs it.

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

## Fibo BBQ Preview tools and prices

- [Fibo Bbq Preview](https://spiral.ai/tools/fal/bria/fibo-bbq-preview/generate) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  | — | Prompt for image generation. |
| aspect_ratio | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 | 1:1 | Aspect ratio. Options: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 |
| structured_prompt |  | — | The structured prompt to generate an image from. |
| image_url |  | — | Reference image (file or URL). |
| seed |  | 5555 | Random seed for reproducibility. |
| steps_num | 20 to 50 | 50 | Number of inference steps. |

## What can you do with Fibo BBQ Preview in Windsurf?

Create project imagery around the layout and color values already in your code. Turn those requirements into structured scene descriptions, then inspect generated compositions in the page.

### Product scene concepts

Plan a bottle, pedestal, and prop arrangement with explicit positions and target colors before commissioning a shoot.

### Ad composition drafts

Place the subject to one side and reserve open space for a headline added during design.

### Color direction reviews

Compare target object colors while keeping the scene description and seed fixed.

### Website image concepts

Generate scenes whose object placement follows a page layout, then review them in the intended crop.

### Still life layout studies

Test arrangements of ceramics, fruit, or furniture by changing one object's box at a time.

### Art direction comparisons

Explore lighting, camera angle, material, and texture descriptions around a defined composition.

## Overview

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

## Fibo BBQ Preview in other agents

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

## More Windsurf guides

- [Fibo 2.0 Generate](https://spiral.ai/integrations/windsurf/fibo-2-0-generate)
- [Fibo Edit](https://spiral.ai/integrations/windsurf/fibo-edit)
- [Fibo 2.0 Edit](https://spiral.ai/integrations/windsurf/fibo-2-0-edit)
- [Fibo Edit Add Object by Text](https://spiral.ai/integrations/windsurf/fibo-edit-add-object-by-text)
- [FeyNoBg](https://spiral.ai/integrations/windsurf/feynobg)
- [Fibo Edit Blend](https://spiral.ai/integrations/windsurf/fibo-edit-blend)

## Questions about Fibo BBQ Preview in Windsurf

**Can Windsurf use Fibo BBQ Preview?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Fibo BBQ Preview like any built-in tool.

**How much does Fibo BBQ Preview cost in Windsurf?**

$0.052 per image. 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 Fibo BBQ Preview in Windsurf?**

No. Spiral runs Fibo BBQ Preview on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Fibo BBQ Preview in Windsurf?**

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

**Does Windsurf wait while Fibo BBQ Preview runs?**

Fibo BBQ Preview runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

**What is Fibo BBQ best suited to?**

Image briefs with defined layouts and target colors. Its numeric boxes and RGB conditioning make it a useful choice for product scene concepts and compositions with space reserved for copy.

**How does Fibo BBQ differ from FIBO?**

Fibo BBQ extends structured scene descriptions with numeric object positions and colors. That gives you a more explicit way to describe placement than qualitative directions alone.

**Can Fibo BBQ place objects exactly?**

Treat bounding boxes as generation targets and inspect the result. In Bria's spatial grounding tests, BBQ still trails the specialized InstanceDiffusion model.

**How should I refine an image without changing the whole scene?**

Keep the seed and structured description, then change only the object position or color you want to test. Bria demonstrates this workflow with surrounding content remaining largely unchanged, so compare each result before accepting it.

**What output resolution is documented for Fibo BBQ Preview?**

The documented example returns a 1024 by 1024 PNG. That example is not evidence of a maximum resolution or a guarantee for every image shape.

