Skip to main content
POST
Create a product-photography shoot

Authorizations

x-api-key
string
header
required

Body

application/json
product_image_urls
string<uri>[]
required

Public http(s) URLs of your product image(s).

style
enum<string>
required
Available options:
classic,
minimal,
luxury,
loud_luxury,
magazine,
editorial,
avant_garde,
element,
influencer,
lifestyle
mode
enum<string>
default:product_only
Available options:
product_only,
with_model
model_url
string<uri>

Required when mode is with_model. A public image URL of the model.

shots
enum<integer>
default:4

6 is honored only for classic/minimal; otherwise clamped to 4.

Available options:
1,
4,
6
aspect_ratio
string
default:1:1
quality
enum<string>
default:standard

standard = 1 credit/image, pro = 2, 4k = 4.

Available options:
standard,
pro,
4k
background_color
string
callback_url
string<uri>

Optional; reserved for push delivery (poll in the meantime).

Response

Shoot created

id
string
object
string
Example:

"shoot"

status
enum<string>
Available options:
pending,
analyzing,
analyzed,
generating,
completed,
failed
shots
integer
shots_adjusted
boolean

Present and true when a requested 6 was clamped to 4 (non classic/minimal style).

credits_used
integer
credits_remaining
integer
images
object[]
created_at
string<date-time>