Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable now

Bria Product Dimensions

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.

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

FieldKindDefaultDescription
title_positionone of
top_left, top_center, top_right
top_center

Title placement along the top.

proportional_linestrue or falsetrue

Scale dimension line lengths by measurement.

synctrue or falsefalse

When true, return generated images directly as base64 instead of CDN URLs.

image requiredtext—

Source product image as a public URL or raw base64-encoded image bytes.

dimensions requiredJSON—

Dimension callouts to render. At least one entry is required.

style requiredone of
default, childlike, elegant
—

Rendering style.

titletext—

Optional headline above the product.

output_sizenumber (whole)
256 to 2200
2200

Square output edge length in pixels.

output_formatone of
png, jpeg, dual
png

Controls the rendered response: png, jpeg, or dual composite plus transparent overlay.

backgroundtextwhite

Hex color or one of: white, cream, charcoal.

units_displayone of
single, dual_bullet, dual_slash, dual_parens
single

How labels display primary and secondary units when both are provided.

weightJSON—

Optional weight badge below the product.

capacityJSON—

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.