store_generate_mockup
Generate a product mockup with a logo.
Composes a store_logo onto a store_product image at the given placement, then optionally runs the result through OpenAI image edit (mode='polish', default) for a photoreal finish. mode='quick' returns the Sharp composite (free, instant). Placement uses normalized ratios.
Request
arguments
{
"slug": "string",
"store_product_id": "uuid",
"store_logo_id": "uuid",
"face": "\"front\" | \"back\"",
"placement": {
"anchor_x_ratio": "number // 0..1",
"anchor_y_ratio": "number // 0..1",
"scale_ratio": "number // 0.02..1",
"rotation_deg": "number // -180..180"
},
"mode": "\"quick\" | \"polish\" // default \"polish\""
}Response
content[0].text (JSON-parsed)
{
"mockup_id": "uuid",
"mockup_url": "string",
"engine": "\"sharp\" | \"openai\"",
"ms_elapsed": "number"
}Example
tool call
{
"name": "store_generate_mockup",
"arguments": {
"slug": "bravo",
"store_product_id": "2b3c4d5e-…",
"store_logo_id": "1a2b3c4d-…",
"face": "front",
"placement": { "anchor_x_ratio": 0.5, "anchor_y_ratio": 0.32, "scale_ratio": 0.22, "rotation_deg": 0 },
"mode": "polish"
}
}Related tools