# Batch variations

> Start up to 4 takes on one brief in a single call, each its own job.

Source: https://developers.mnml.ai/docs/batch-variations

`count` starts variations of the same brief. Each is its own job and its own charge, so 4 variations of v4.6 cost $0.99. The answer lists every job in `ids`.

**variations.sh**

```bash
curl -X POST https://api.mnml.ai/v2/renders \
  -H "Authorization: Bearer $MNML_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: facade-options-2026-10-04" \
  -d '{
    "engine": "v4.6-ultra",
    "mode": "exterior",
    "image": "https://example.com/massing.png",
    "prompt": "Brick and bronze, dusk, street trees",
    "count": 4
  }'
```

## Good to know

- Poll each id in `ids`. One that fails is refunded on its own; the others carry on.
- The set starts whole or not at all for the concurrent-jobs limit: if there is no room for all of them, nothing starts and the answer says so.
- Send an `Idempotency-Key`, as above, so a retried request returns the same set instead of starting another.
- To compare prompts rather than takes, send one request per prompt, each with its own key.