Handheld Product Mockup API
nexscope_handheld_product_mockupGenerate natural hand-held product imagery from a person image and target product asset.
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": {
"imageUrl": "<imageUrl>",
"targetOriginUrl": "<targetOriginUrl>",
"targetMaskUrl": "<targetMaskUrl>"
},
"name": "nexscope_handheld_product_mockup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| imageUrl | Yes | Public URL of the product image. The image must be at most 20 MB and between 385 and 8192 pixels in both width and height. | |
| outputNum | No | Number of images to generate, from 1 to 4. Defaults to 1. | |
| targetMaskUrl | Yes | Public URL of the black-and-white hand-held area mask. Required because this API accepts custom pose images rather than saved upstream materials. | |
| targetOriginUrl | Yes | Public URL of the person or hand pose image. |