Start a new create-packshot job.

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

AuthorizationBearer <token>

Token-based authentication using access tokens.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

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).

Items1 <= items <= 10

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

`application/json`

curl -X POST "https://v2.api.piktid.com/create-packshot" \  -H "Content-Type: application/json" \  -d '{    "project_id": "string",    "images": [      "string"    ],    "instructions": [      {        "style": "flat_lay"      }    ]  }'

{
  "job_id": "string",
  "status": "string",
  "message": "string",
  "total_outputs": 0
}

{
  "error": "Invalid request",
  "detail": [
    {
      "field": null,
      "message": "string",
      "position": "query"
    }
  ]
}

Empty

Start a new create-packshot job.

Authorization

Request Body

Response Body

200application/json

400application/json

402

403

404

429

`application/json`

`application/json`