Nodes/BRIA AI API nodes/Shot by Text - Manual Placement
ComfyUI Node

Shot by Text - Manual Placement

Anchor your product, describe the rest

By Bria-AI·Created 2 years ago·Updated 3 months ago· 95
Shot by Text - Manual Placement
  • image
  • output_image
api_keyBRIA_API_TOKEN
scene_description
modefast
shot_size1000, 1000
manual_placement_selectionupper_left
force_rmbgfalse
content_moderationfalse
optimize_descriptiontrue
exclude_elements

ShotByTextManualPlacement (shown as Shot by Text - Manual Placement) gives you the best of both product-shot worlds: a written scene description for the background, and a fixed named position for your product. Describe the room, tell Bria the product sits bottom-right, and the model builds a scene that works around that anchor.

The text-driven Automatic nodes let the model place the product wherever it likes, which is fine for exploring and frustrating when it matters. This is the node for the "settled" version of an idea - you've committed to a layout, and now you want the scene to bend to it instead of the other way around.

How it works

Inputs: image (product), scene_description, shot_size (default 1000, 1000), and manual_placement_selection - ten named positions (upper_left, upper_right, bottom_left, bottom_right, left_center, right_center, upper_center, bottom_center, center_vertical, center_horizontal). It calls Bria's /v1/product/lifestyle_shot_by_text endpoint with the manual_placement type. Text controls carry over: mode (base / fast / high_control, default fast), optimize_description (default true), exclude_elements, plus force_rmbg and 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 downloads, no GPU - cloud call needing a BRIA API token from platform.bria.ai, billed per generation.

Practical notes

Write the description to match the anchor. If the product is bottom_center and your prompt fills the scene with countertop clutter at the bottom, you're fighting yourself - describe open space where the product will sit, like a human art director would. And watch the same limitation as every manual placement node: ten named slots only, no fine-tuning. When "bottom_left" is almost right but not quite, Custom Coordinates is the upgrade, letting you type the exact x, y position instead.

CategoryAPI Nodes

Inputs (10)

NameTypeDefaultDescription
api_keySTRINGBRIA_API_TOKEN
imageIMAGE
scene_descriptionSTRING
modeCOMBOfast3 options: base, fast, high_control
shot_sizeSTRING1000, 1000
manual_placement_selectionCOMBOupper_left10 options: upper_left, upper_right, bottom_left, bottom_right, right_center, left_center, +4
force_rmbgoptBOOLEANfalse
content_moderationoptBOOLEANfalse
optimize_descriptionoptBOOLEANtrue
exclude_elementsoptSTRING

Outputs (1)

NameTypeDescription
output_imageIMAGE