Create packshot

Start a new job

POST
/create-packshot

Takes 1-10 garment-bearing images and produces packshot outputs based on the instructions list (one output per instruction × num_variations). No model identity is involved — outputs are product-only.

Authorization

token_auth
headerAuthorizationBearer <token>

Token-based authentication using access tokens.

Request Body

application/json
  1. body
ai_retouch?Ai Retouch

auto: once the AI reviewer has checked the outputs, the AI retoucher fixes what it flagged on each image, once, without being asked. Each fixed image costs the AI retouch price, charged only when an image is fixed. Enterprise only for now, and not with review_config (images in a review round are retouched from the review screen); otherwise ignored. quality_summary.settled on GET /jobs//results, or the job_quality notification, tells when it is done.

Default"off"
Value in"off""auto"
project_id*Project Id

The project identifier where input images are stored.

images*array<string|>

List of garment-bearing image UUIDs or objects with file_id and optional note. Accepts both formats for backward compatibility:

  • Simple: ["uuid-1", "uuid-2"]
  • With annotations: [{"file_id": "uuid-1", "note": "front view"}, {"file_id": "uuid-2"}]
Items1 <= items <= 10
instructions?array<>

List of instructions — each produces ONE output image (× num_variations). Each instruction MUST have a style (no default — packshot apps requires explicit style). Required unless template_id is sent; mutually exclusive with it.

Items1 <= items <= 10
template_id?|

ID of a saved template to run instead of sending instructions. Each preset in the template becomes one instruction (newest preset first), and the first preset's processing options (engine, post-processing, look, ...) apply unless this request sets them explicitly. Mutually exclusive with instructions.

Defaultnull
post_process?Post Process

Enables or disables post processing for all images in the batch.

Defaultfalse
options?

Global options applied to all instructions (can be overridden per-instruction). Notable fields:

  • model: "auto" | "nano_banana_2" | "nano_banana_pro" | "seedream"
  • use_anchor: bool (default False) — generate instruction 0 first synchronously, then fan out the rest with the anchor as a reference image. Use for cross-style visual consistency (e.g., front + back of the same garment).
  • anchor_index: int (default 0) — which instruction is the anchor reference.
Default{}
review_config?|

Optional review configuration. If provided, creates a review pipeline.

Defaultnull

Response Body

Successful Response

application/json
  1. response
job_id*Job Id

The ID of the created create-packshot job.

status*Status

The initial status of the job.

message*Message

A message indicating the job creation status.

total_outputs*Total Outputs

Number of output images that will be generated.

curl -X POST "https://example.com/create-packshot" \  -H "Content-Type: application/json" \  -d '{    "project_id": "string",    "images": [      "string"    ]  }'
{  "job_id": "string",  "status": "string",  "message": "string",  "total_outputs": 0}