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

falImageAvailable now

Bria Product Shot

fal-ai/bria/product-shot

Edit and enhance images with Bria Product Shot 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 generation. Billed on num_results, default 1.

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
image_url requiredURL or file—

The URL of the product shot to be placed in a lifestyle shot. If both image_url and image_file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB.

scene_descriptiontext—

Text description of the new scene or background for the provided product shot. Bria currently supports prompts in English only, excluding special characters.

ref_image_urltext

The URL of the reference image to be used for generating the new scene or background for the product shot. Use "" to leave empty.Either ref_image_url or scene_description has to be provided but not both. If both ref_image_url and ref_image_file are provided, ref_image_url will be used. Accepted formats are jpeg, jpg, png, webp.

optimize_descriptiontrue or falsetrue

Whether to optimize the scene description

num_resultsnumber (whole)
1 to 4
1

The number of lifestyle product shots you would like to generate. You will get num_results x 10 results when placement_type=automatic and according to the number of required placements x num_results if placement_type=manual_placement.

fasttrue or falsetrue

Whether to use the fast model

placement_typeone of
original, automatic, manual_placement, manual_padding
manual_placement

This parameter allows you to control the positioning of the product in the image. Choosing 'original' will preserve the original position of the product in the image. Choosing 'automatic' will generate results with the 10 recommended positions for the product. Choosing 'manual_placement' will allow you to select predefined positions (using the parameter 'manual_placement_selection'). Selecting 'manual_padding' will allow you to control the position and size of the image by defining the desired padding in pixels around the product.

original_qualitytrue or falsefalse

This flag is only relevant when placement_type=original. If true, the output image retains the original input image's size; otherwise, the image is scaled to 1 megapixel (1MP) while preserving its aspect ratio.

shot_sizelist[1000,1000]

The desired size of the final product shot. For optimal results, the total number of pixels should be around 1,000,000. This parameter is only relevant when placement_type=automatic or placement_type=manual_placement.

manual_placement_selectionone of
upper_left, upper_right, bottom_left, bottom_right, right_center, left_center, upper_center, bottom_center, center_vertical, center_horizontal
bottom_center

If you've selected placement_type=manual_placement, you should use this parameter to specify which placements/positions you would like to use from the list. You can select more than one placement in one request.

padding_valueslist—

The desired padding in pixels around the product, when using placement_type=manual_padding. The order of the values is [left, right, top, bottom]. For optimal results, the total number of pixels, including padding, should be around 1,000,000. It is recommended to first use the product cutout API, get the cutout and understand the size of the result, and then define the required padding and use the cutout as an input for this API.

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": "fal-ai/bria/product-shot",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/bria/bria_product_fg.jpg"
    }
  }'

Frequently asked questions

How much does Bria Product Shot cost?

$0.052 per generation. Billed on `num_results`, default 1. 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 Shot through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/bria/product-shot"` 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 Shot?

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

Can my AI agent use Bria Product Shot?

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