Get started

Idempotency

Send an Idempotency-Key header (8 to 64 letters, digits, - or _) with every POST /v1/images. If the network drops and you send the same request again, you get the same generation back and are never charged twice. Keys are remembered for 24 hours.

• The same key and the same body: 200 with the generation the first request made.
• The same key with a different body: 409 idempotency_conflict.
• A good key is something you already have that identifies the photo, such as a SKU plus the view: tshirt-red-m-front-v1.