Rendus

POST /v1/renders rend un modèle en image ou PDF.

# Requête

bash

curl https://api.mostlyrender.com/v1/renders \
  -H "Authorization: Bearer mr_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "tpl_abc",
    "modifications": { "title": "Hello" },
    "output": "png"
  }'

Champ	Type	Notes
`template`	string	Obligatoire. L’identifiant du modèle. (`templateId` est aussi accepté.)
`modifications`	object	Surcharges de calque, indexées par nom de calque. Voir Templates as parameters.
`output`	string	`png` (par défaut), `jpeg`, `webp`, ou `pdf`.
`async`	boolean	Mettre le travail en file d’attente et retourner `202` au lieu de rendre en ligne.
`webhookUrl`	string	Rappel signé à la fin (implique `async`). Voir Async & webhooks.
`notifyEmail`	string	Envoyer un e-mail à cette adresse quand le travail est terminé (implique `async`).

# Réponse

json

{
  "id": "rnd_abc123",
  "url": "https://img.mostlyrender.com/mostlyrender/renders/rnd_abc123.png",
  "output": "png"
}

L’url est publique et mise en cache par CDN. Les rendus sont aussi enregistrés dans l’app sous Usage.

# Formats de sortie

png — sans perte, transparence. Par défaut.
jpeg / webp — plus petit ; bon pour les photos.
pdf — vectoriel, excellent pour les ressources prêtes à l’impression.

# SDK

python

out = mr.render("tpl_abc", modifications={"title": "Hello"}, output="pdf")
print(out["url"])

Pour beaucoup d’images en un seul appel, voir Batch. Pour l’intégration <img>/OG sans clé API, voir Signed render URLs.