Place Product in Scene
sirv_place_product_in_scenePlace a product from an image into a new lifestyle scene described in text or styled by a reference image, creating 1–4 variations for marketing and listing photos.
Instructions
Place the product from one image into a new lifestyle scene. Describe the scene in scene_description, or give a style image in ref_image_url. Makes 1 to 4 variations.
Use it for marketing and listing photos. For a simple backdrop, use sirv_replace_background. To show clothing on a person, use sirv_try_on_garment.
The default model keeps the product's own pixels. The source image does not change. Returns the result URLs.
Credits: spends workspace credits. The cost depends on the model and options.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"image_url": "<image_url>"
},
"name": "sirv_place_product_in_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Model. ideogram-keep keeps the product's own pixels; the others can redraw the product. Default: ideogram-keep | ideogram-keep |
| position | No | Where the product sits, for manual_placement | |
| image_url | Yes | Public URL of the product image. A transparent background works best | |
| num_results | No | How many variations to make, 1 to 4. Default: 1 | |
| ref_image_url | No | Public URL of an image whose style the scene copies. Give this or scene_description | |
| placement_type | No | How the product is placed. original keeps its place in the photo; manual_placement uses position. Default: automatic | automatic |
| scene_description | No | The scene, in words. Give this or ref_image_url |