Render a preview mockup

post/v1/mockups

Request

  • Base URL: https://pod.agentmade.dev
  • URL: https://pod.agentmade.dev/v1/mockups
  • Auth: none declared

Request body

artwork_idstring required
product_idstring required
colorstring required

Product colour, e.g. "black".

sizestring
style'flat' | 'packshot'

flat: quick placement drawing. packshot: product photo with the exact print at real size (where a product photo exists).

placementstring

Print location on the product, e.g. "front" or "back". See get_product for the list.

presetstring

Named position inside the placement, e.g. "center_chest", "left_chest", "full_front". Defaults to the placement default.

width_mmnumber

Exact printed width of the visible artwork in millimetres. Height follows the aspect ratio.

height_mmnumber

Maximum printed height in millimetres.

top_mmnumber

Distance from the top of the print area to the top of the artwork.

left_mmnumber

Distance from the left edge of the print area. Default: horizontally centred.

Response

Mockup URL

mockup_urlstring required

PNG preview of the exact print on the product.

style'flat' | 'packshot' required
blank_image_urlstring nullable required
validation_status'PASS' | 'WARN' | 'FAIL' required
summarystring required
image_promptstring required

A prompt for your own image model, to make an illustration from mockup_url.

notestring required

Changes

No recorded changes to this operation across all 1 revision of this API.