Nodes/BRIA AI API nodes/Shot by Image - Automatic Aspect Ratio
ComfyUI Node

Shot by Image - Automatic Aspect Ratio

Free composition at a target shape

By Bria-AI·Created 2 years ago·Updated 3 months ago· 95
Shot by Image - Automatic Aspect Ratio
  • image
  • ref_image
  • output_image
api_keyBRIA_API_TOKEN
aspect_ratio1:1
force_rmbgfalse
content_moderationfalse
enhance_ref_imagetrue
ref_image_influence1.00

ShotByImageAutomaticAspectRatio (shown as Shot by Image - Automatic Aspect Ratio) is the aspect-ratio-flavored member of the automatic shot family. Everything about ShotByImageAutomatic applies - product photo plus reference image, model composes the scene freely - but instead of specifying the output canvas as pixel dimensions (shot_size), you pick an aspect_ratio and the model fills that shape. One output instead of seven, because this variant is built for delivering a finished shot at a known ratio, not a spread of candidates.

Reach for it when you know the target format before you generate: a 9:16 for social, 16:9 for a hero banner, 1:1 for a marketplace listing. You skip the "generate, then crop" step, and because the scene is generated directly into the ratio, nothing important gets cut off in the crop.

How it works

Inputs: image (product), ref_image (scene reference), and aspect_ratio - the usual nine options (1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9), default 1:1. It calls Bria's /v1/product/lifestyle_shot_by_image endpoint with the automatic_aspect_ratio placement type, and the shared controls carry over: enhance_ref_image (default true), ref_image_influence (0–1, default 1.0), force_rmbg, content_moderation. One output: output_image.

Installing it

Part of the BRIA AI API nodes pack (Bria-AI/ComfyUI-BRIA-API). ComfyUI Manager → search BRIA API → install, or:

cd ComfyUI/custom_nodes
git clone https://github.com/Bria-AI/ComfyUI-BRIA-API

Restart ComfyUI; it's under API Nodes. No models, no GPU - cloud call needing a BRIA API token from platform.bria.ai, billed per generation.

Practical notes

The tradeoff is obvious once you use it: you get exactly one shot at the ratio, so if the composition comes out wrong you're paying for another call. The Automatic seven-candidate node is a better fit when you're still deciding; this one is for when the format is decided and you need a delivered asset. Keep the reference image's own framing in mind - an ultrawide scene reference asked to fill a 9:16 canvas can produce awkward cropping on the product. If that keeps happening, drop to Manual Placement and pin the product yourself.

CategoryAPI Nodes

Inputs (8)

NameTypeDefaultDescription
api_keySTRINGBRIA_API_TOKEN
imageIMAGE
ref_imageIMAGE
aspect_ratioCOMBO1:19 options: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, +3
force_rmbgoptBOOLEANfalse
content_moderationoptBOOLEANfalse
enhance_ref_imageoptBOOLEANtrue
ref_image_influenceoptFLOAT1.000–1

Outputs (1)

NameTypeDescription
output_imageIMAGE