Batch variations
Start up to 4 takes on one brief in a single call, each its own job.
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.
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.