Rendert

POST /v1/renders rendert eine Vorlage in ein Bild oder PDF.

# Anfrage

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"
  }'

Feld	Typ	Hinweise
`template`	string	Erforderlich. Die Template-ID. (`templateId` wird ebenfalls akzeptiert.)
`modifications`	object	Layer-Überschreibungen, indiziert nach Layer-Name. Siehe Templates als Parameter.
`output`	string	`png` (Standard), `jpeg`, `webp` oder `pdf`.
`async`	boolean	Stelle den Job in die Warteschlange und gib `202` zurück, statt inline zu rendern.
`webhookUrl`	string	Signierter Rückruf nach Abschluss (impliziert `async`). Siehe Async & Webhooks.
`notifyEmail`	string	Diese Adresse benachrichtigen, wenn der Job abgeschlossen ist (impliziert `async`).

# Antwort

json

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

Die url ist öffentlich und CDN-zwischengespeichert. Rendert werden auch in der App unter Nutzung protokolliert.

# Ausgabeformate

png — verlustfrei, Transparenz. Der Standard.
jpeg / webp — kleiner; gut für Fotos.
pdf — Vektor, hervorragend für druckfertige Assets.

# SDK

python

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

Für viele Bilder in einem Aufruf siehe Batch. Für <img>/OG-Einbettung ohne API-Schlüssel siehe Signierte Render-URLs.