Lot

POST /v1/renders/batch rend jusqu’à 50 images dans une seule requête. Les éléments s’exécutent en parallèle et sont comptabilisés par élément ; une défaillance sur un élément n’interrompt jamais les autres.

# Deux formes

Un modèle, plusieurs ensembles de modifications — le cas courant :

bash

curl https://api.mostlyrender.com/v1/renders/batch \
  -H "Authorization: Bearer mr_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "tpl_abc",
    "output": "png",
    "items": [
      { "title": "One" },
      { "title": "Two" },
      { "title": "Three" }
    ]
  }'

Chaque élément est un objet modifications, ou { "modifications": {…}, "output": "…" } pour remplacer le format par élément.

Rendus hétérogènes — différents modèles en un seul appel :

json

{
  "renders": [
    { "template": "tpl_a", "modifications": { "title": "A" }, "output": "png" },
    { "template": "tpl_b", "modifications": { "title": "B" }, "output": "pdf" }
  ]
}

# Réponse

json

{
  "results": [
    { "id": "rnd_1", "url": "https://img.mostlyrender.com/mostlyrender/renders/rnd_1.png", "output": "png" },
    { "error": "render failed" }
  ],
  "count": 2,
  "ok": 1
}

results est positionnel — chaque entrée est soit un résultat de rendu, soit un objet { "error" }. count est le total traité ; ok est le nombre de réussis.

# SDK

python

res = mr.render_batch(
    template_id="tpl_abc",
    output="png",
    items=[{"title": "One"}, {"title": "Two"}, {"title": "Three"}],
)
print(res["count"], res["ok"])

Pour les lots plus grands que 50, divisez en plusieurs requêtes, ou utilisez les tâches asynchrones.