Imágenes

Un documento puede usar dos tipos de imagen:

• imágenes que subes a tu cuenta, referenciadas como asset:<id>;
• imágenes incrustadas en el HTML como URL data:.

Nada más se carga. Un <img> que apunta a una dirección web se ignora y se informa, porque el servicio nunca descarga una dirección que esté en una plantilla.

Subir

Sube un PNG o JPEG en el portal, en Images, o mediante la API. El cuerpo de la petición es la imagen sin más:

curl -X POST "https://api.example.com/v1/assets?name=logo.png" \
  -H "Authorization: Bearer $RUSTEDF_KEY" \
  --data-binary @logo.png

{
  "id": "0194f2c0-…",
  "name": "logo.png",
  "content_type": "image/png",
  "size": 8123,
  "reference": "asset:0194f2c0-…",
  "created_at": 1760000000
}

Usa la reference como origen de la imagen:

<img src="asset:0194f2c0-…" width="120" alt="Logotipo de la empresa">

La referencia también puede venir de tus datos: <img src="{{ logo }}"> con "logo": "asset:0194f2c0-…".

Reglas

• Solo PNG y JPEG, hasta 5 MB cada una. El tipo se comprueba por el propio archivo, no por el nombre.
• Tu plan limita el tamaño total de las imágenes; consulta Planes y créditos.
• Las imágenes son privadas de tu cuenta. El id de una imagen de otra cuenta no funciona en tus documentos.
• Borra una imagen con DELETE /v1/assets/{id}. Los documentos que aún la referencian se generan sin ella.

URL data

Para una imagen pequeña que cambia en cada documento, como un código QR, incrústala directamente:

<img src="data:image/png;base64,iVBORw0KGgo…">

Las imágenes muy grandes o de resolución muy alta se rechazan con un aviso, en lugar de ralentizar la generación.