Photoshoot

Product photoshoot

Catalogue photos of the garment alone — packshots, flatlays, hanging and detail shots — from the mockup /api/mockup/render produced, so colour and print stay exact. Pick one to twelve shot types and a style.

post/api/photoshoot/v3/generate-product

Request

  • Base URL: https://api.crayonz.ai
  • URL: https://api.crayonz.ai/api/photoshoot/v3/generate-product
  • Auth: API key in header X-API-Key

Request body

compositor_flatlay_urlstring required

Front mockup_url from /api/mockup/render (the colour-true reference)

back_flatlay_urlstring

Back mockup_url, used for shots whose side is back

shot_typesstring[] required

packshot_white, flatlay_overhead, flatlay_stack, hanging_hanger, hanging_rope, backlit_window, fabric_face, collar_rib, seam_stitch, care_label, on_bed_props, on_chair_back, next_to_sneaker, size_compare_layflat, fingertips_wall, half_tuck_waistband, pocket_shot, wide_flatlay, hanging_hanger_wide

shot_sidesstring[]

front or back per shot, same length as shot_types; defaults to front

style_preset'studio_clean' | 'editorial_moody' | 'catalog_flat' | 'lifestyle_warm'
style_reference_urlstring

Optional mood-board or campaign photo to match

garment_typestring

tshirt, oversized_tshirt, hoodie, zipper_hoodie, polo, acid_wash_tshirt

garment_color_hexstring
garment_color_namestring
seedinteger

Example request

{
  "compositor_flatlay_url": "https://…/mockups/…/front.png",
  "shot_types": [
    "packshot_white",
    "flatlay_overhead"
  ],
  "style_preset": "studio_clean",
  "garment_type": "tshirt",
  "garment_color_hex": "#ffffff",
  "garment_color_name": "white"
}

Response

Success

shotsobject[]

One entry per shot: shot_type, visible_side, url, style_preset, cost_usd

model_usedstring

Changes

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