Place Product in a Scene
place_productPut the user's own product photo into a real-looking scene, keeping the product as it is (no people, faces or added text). Paid plans only. The photo must already be uploaded to HalalGen: pass its link as product_image_url, or call without it to list the user's uploads. Scenes: marble counter, desert dunes, boutique shelf, kitchen table, Ramadan lantern table, colour backdrop, or one they describe. 1–4 pictures, charged per picture (see list_models or estimate_cost).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "place_product"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | How big the product is in the frame. | medium |
| count | No | How many pictures (each one is charged). | |
| light | No | morning = soft bright light, golden = warm sunset light, night = dark with warm lamps. | morning |
| scene | No | marble = white marble kitchen counter, dunes = desert sand dunes, shelf = boutique shop shelf, kitchen = rustic kitchen table, lantern = Ramadan table with brass lanterns and dates, studio = plain colour backdrop, custom = describe it in custom_scene. | studio |
| position | No | Where the product sits in the picture. | center |
| aspect_ratio | No | Picture shape: 1:1 square, 4:5 feed post, 9:16 story, 16:9 banner. | 1:1 |
| custom_scene | No | Only for scene 'custom': where the product stands, e.g. 'on a stone step beside a small fountain in a tiled courtyard'. No people. | |
| backdrop_color | No | Only for scene 'studio': the backdrop colour. | sand |
| product_image_url | No | Link to a product photo the user uploaded to HalalGen (https://api.halalgen.ai/image/uploads/... or https://cdn.halalgen.ai/uploads/...). Other links are refused. Leave empty to list the user's uploads. |