> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aigenstudio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Process catalog batches

> Send multiple images in one create request and track results as one job.

Most create endpoints accept up to 20 input images. AI Gen Studio expands each image into one or more results depending on `output.number_of_images`.

Example:

```json theme={"theme":{"light":"github-light","dark":"github-light"}}
{
  "input": [
    { "image_url": "https://client.example/images/sku-001.jpg", "external_id": "sku-001" },
    { "image_url": "https://client.example/images/sku-002.jpg", "external_id": "sku-002" }
  ],
  "operations": {
    "adjustments": { "light": true, "color": true },
    "background": { "type": "white", "shadow": "natural" }
  },
  "output": { "format": "png" }
}
```

Send this body to:

```txt theme={"theme":{"light":"github-light","dark":"github-light"}}
POST /image/edit
```

## Limits

```txt theme={"theme":{"light":"github-light","dark":"github-light"}}
Maximum results per job: 20
Maximum active jobs per API key: 1
Maximum active jobs per account: 2
```

For larger catalogs, split work on your side and enqueue the next job after the current one reaches a terminal state.

## Partial completion

A job can become `partially_completed` when some results complete and others fail. Read `results[]` from `GET /jobs/{jobId}` to decide which items need retrying.