Description
The Product Pack Shot feature is designed to create professional standard pack shots. The output is a 2000x2000 px image, with the product size and location according to best practices. This feature can allow users to take any photo of a product and transform it into a professional pack shot, placing the product on a clean, seamless background, typically white but customizable to any color.
This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content or if the modified output would contain inappropriate content.
The URL of the product image or product cutout. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB.
The product image or product cutout file, in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB.
The background hex color code for the pack shot. Optionally, use 'transparent' for a transparent background. This parameter is optional.
Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels.
When enabled, applies content moderation to both input visuals and modified outputs.
For input images:
- Processing stops if the image fails moderation
- Returns a 422 error with details about which parameter failed
For output images:
- If the modified image fails moderation, returns a 422 error
# The Python SDK covers v2 endpoints; call this v1 endpoint over HTTP.
import os
import httpx
response = httpx.post(
"https://engine.prod.bria-api.com/v1/product/packshot",
headers={"api_token": os.environ["BRIA_API_TOKEN"]},
json={
"image_url": "https://labs-assets.bria.ai/sandbox-example-inputs/product_packshot_example_image.jpg",
"background_color": "#FFFFFF",
},
timeout=120,
)
response.raise_for_status()
print(response.json()){ "result_url": "URL" }