# Bria Product Dimensions

Generate and edit images with Bria Product Dimensions from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image
- Tool id: `fal` / `bria/product-dimensions`
- Page: https://spiral.ai/tools/fal/bria/product-dimensions

## Pricing

$0.052 per image.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `title_position` | one of | top_left, top_center, top_right | top_center | Title placement along the top. |
| `proportional_lines` | true or false |  | true | Scale dimension line lengths by measurement. |
| `sync` | true or false |  | false | When true, return generated images directly as base64 instead of CDN URLs. |
| `image` (required) | text |  | — | Source product image as a public URL or raw base64-encoded image bytes. |
| `dimensions` (required) | JSON |  | — | Dimension callouts to render. At least one entry is required. |
| `style` (required) | one of | default, childlike, elegant | — | Rendering style. |
| `title` | text |  | — | Optional headline above the product. |
| `output_size` | number (whole) | 256 to 2200 | 2200 | Square output edge length in pixels. |
| `output_format` | one of | png, jpeg, dual | png | Controls the rendered response: png, jpeg, or dual composite plus transparent overlay. |
| `background` | text |  | white | Hex color or one of: white, cream, charcoal. |
| `units_display` | one of | single, dual_bullet, dual_slash, dual_parens | single | How labels display primary and secondary units when both are provided. |
| `weight` | JSON |  | — | Optional weight badge below the product. |
| `capacity` | JSON |  | — | Optional capacity badge below the product. |

## Example

```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/product-dimensions",
    "input": {
      "image": "https://bria-datasets.s3.us-east-1.amazonaws.com/product_dimensions/water+bottle+fal/water_bottle_white_background.png",
      "dimensions": [
        {
          "name": "height",
          "unit": "cm",
          "value": 22,
          "position": "left"
        },
        {
          "name": "width_bottom",
          "unit": "cm",
          "value": 7,
          "position": "bottom"
        }
      ],
      "style": "default"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=bria%2Fproduct-dimensions

## Common questions

### Bria Product Dimensions

**How much does Bria Product Dimensions cost?**

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

**How do I use Bria Product Dimensions through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bria/product-dimensions"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Bria Product Dimensions?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Bria Product Dimensions?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

