Concepts
Jobs
Understand job states, progress tracking, and per-image outputs
A job is an asynchronous processing request. Jobs are created when you use Model swap or Flat lay on model.
Job lifecycle
Core fields:
| Field | Description |
|---|---|
status | Current job status (see diagram above) |
total_images | Number of images submitted |
processed_images | Number of images completed so far |
progress | Completion percentage (0–100) |
error_message | Reason for failure, if any |
Image results
Each job produces one or more output images. Use the results endpoint to retrieve them.
If a job processes multiple input images, each result includes an image_index so you can map outputs back to the original input.
Abort and regenerate
- You can abort a job that is still in progress.
- You can regenerate a specific output image without rerunning the entire job.