Render

POST /v1/renders esegue il rendering di un template in un’immagine o PDF.

# Richiesta

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

Campo	Tipo	Note
`template`	string	Obbligatorio. L’ID del template. (`templateId` è accettato anche.)
`modifications`	object	Override dei livelli, indicizzati per nome del livello. Vedi Template come parametri.
`output`	string	`png` (predefinito), `jpeg`, `webp`, o `pdf`.
`async`	boolean	Metti il lavoro in coda e restituisci `202` invece di eseguire il rendering inline.
`webhookUrl`	string	Callback firmato al completamento (implica `async`). Vedi Async e webhook.
`notifyEmail`	string	Invia un’email a questo indirizzo quando il lavoro finisce (implica `async`).

# Risposta

json

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

L’url è pubblico e memorizzato nella cache CDN. I render sono anche registrati nell’app sotto Utilizzo.

# Formati di output

png — senza perdita, trasparenza. Il predefinito.
jpeg / webp — più piccoli; buoni per le foto.
pdf — vettoriale, ottimo per asset pronti per la stampa.

# SDK

python

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

Per molte immagini in una singola chiamata, vedi Batch. Per l’incorporamento di <img>/OG senza una chiave API, vedi URL di render firmati.