Renders

POST /v1/renders renderiza una plantilla a una imagen o PDF.

# Solicitud

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	Notas
`template`	string	Requerido. El id de la plantilla. (`templateId` también se acepta.)
`modifications`	object	Sobrescrituras de capas, indexadas por nombre de capa. Ver Templates as parameters.
`output`	string	`png` (por defecto), `jpeg`, `webp`, o `pdf`.
`async`	boolean	Encola el trabajo y devuelve `202` en lugar de renderizar en línea.
`webhookUrl`	string	Devolución de llamada firmada al finalizar (implica `async`). Ver Async & webhooks.
`notifyEmail`	string	Enviar un correo electrónico a esta dirección cuando finalice el trabajo (implica `async`).

# Respuesta

json

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

La url es pública y almacenada en caché por CDN. Los renderizados también se registran en la aplicación bajo Uso.

# Formatos de salida

png — sin pérdida, transparencia. El predeterminado.
jpeg / webp — más pequeños; bueno para fotos.
pdf — vectorial, excelente para activos listos para impresión.

# SDK

python

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

Para muchas imágenes en una sola llamada, ver Batch. Para incrustación <img>/OG sin una clave API, ver Signed render URLs.