Bria Product Dimensions
bria/product-dimensionsGenerate 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.
Pricing
$0.052 per image.
Limits
- Runs
- In the background
- Returns
- image
- 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 | 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. |
Same request in code
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"
}
}'Frequently asked questions
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.