Handheld Product Mockup API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector

API key *

Creative playground

Create with Handheld Product Mockup API

Configure the request visually. The api request remains available in Developer Details.

Source Image*Required

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.

jpg, png, webp · Max 20 megabytes · 1 image · 385–8192 px wide and high

0/1

Original Product Image*Required

Public URL of the person or hand pose image.

jpg, png, webp · Max 20 megabytes · 1 image

0/1

Replacement Mask*Required

Public URL of the black-and-white hand-held area mask. Required because this API accepts custom pose images rather than saved upstream materials.

jpg, png, webp · Max 20 megabytes · 1 image

0/1

Video settings

Number of Images

Choose how many images to generate.

Technical details

Usage estimate unavailable

Preview

Your result will appear here.

The final credit cost appears when your result is ready.