---
title: "Product photoshoot"
method: POST
path: "/api/photoshoot/v3/generate-product"
tags: ["Photoshoot"]
---

# Product photoshoot

`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`

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.

## Request body

- object
  - `compositor_flatlay_url` string, required: Front mockup_url from /api/mockup/render (the colour-true reference)
  - `back_flatlay_url` string: Back mockup_url, used for shots whose side is back
  - `shot_types` string[], 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_sides` string[]: 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_url` string: Optional mood-board or campaign photo to match
  - `garment_type` string: tshirt, oversized_tshirt, hoodie, zipper_hoodie, polo, acid_wash_tshirt
  - `garment_color_hex` string
  - `garment_color_name` string
  - `seed` integer

## Response `200`

Success

- object
  - `shots` object[]: One entry per shot: shot_type, visible_side, url, style_preset, cost_usd
  - `model_used` string

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `402`: Insufficient credits
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crayonz/apis/crayonz-api.md) · [All operations](https://skmtc.dev/crayonz/apis/crayonz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crayonz/apis/crayonz-api/revisions/1114c84167b2?raw)