Flat lay to model

Create PDP images from SKU/article images

This endpoint takes flat/article images (SKUs) and generates Product Detail Page images with the specified model identity wearing the articles.

Unlike model_swap (1 input → 1 output), flat_2_model combines ALL input images and generates multiple outputs based on the instructions list:

  • N input SKU images + M instructions → M output images
  • Each worker receives ALL input images + ONE instruction
  • Workers run in parallel, each producing one output

The processing is handled asynchronously by Celery workers. Use the job status endpoint to monitor progress.

POST
/flat-2-model
AuthorizationBearer <token>

Token-based authentication using access tokens.

In: header

identity_codeIdentity Code

The identity code of the model to use for generating PDP images.

imagesImages

List of SKU/article image keys - ALL images are combined for each output.

instructions?Instructions

List of instructions - each instruction produces ONE output image. The number of instructions determines the number of output images (parallel workers). If empty, a single default instruction will be used.

options?Options

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

Default{}

Empty Object

post_process?Post Process

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

Defaultfalse
project_idProject Id

The project identifier where SKU/article images are stored.

Response Body

Examples

curl -X POST "https://loading/flat-2-model" \
  -H "Content-Type: application/json" \
  -d '{
    "identity_code": "string",
    "images": [
      "string"
    ],
    "project_id": "string"
  }'
{
  "job_id": "string",
  "message": "string",
  "status": "string",
  "total_outputs": 0
}
Empty