Creates enriched product shots by placing them in various environments using textual descriptions.
In addition, you can adjust the background of the product by replacing it with a solid color. To do this, specify a hex color code (e.g., #FF5733) in the scene_description
.
This feature is only available when generating a single result (num_results=1
).
This endpoint also allows adjusting the position of the product and the size of the final product shot.
This enables the creation of new and unique variations of your original product image while maintaining control over layout and format.
To control product positioning and shot dimensions, use the placement_type
parameter, which offers several control modes:
original
: preserves the original position and size of the product from the input image.
automatic
: generates results with 7 recommended placements, while the shot_size is defined by the 'shot_size' parameter.
manual_placement
: allows choosing from predefined positions using manual_placement_selection
. The shot_size is defined by the 'shot_size' parameter.
custom_coordinates
: provides full control over the product's size and location using foreground_image_size
and foreground_image_location
. The shot_size is defined by the 'shot_size' parameter.
manual_padding
: lets you define padding in pixels around the product to control both size and placement.
automatic_aspect_ratio
: centers the product and resizes the canvas automatically to match the specified aspect_ratio
.
The parameters used for positioning and sizing depend on the selected placement_type
. Refer to the documentation for each mode to understand the supported fields and behaviors.
This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content, and filters out unsafe modified images - the first blocked input image will fail the entire request.