Imagens

Um documento pode usar dois tipos de imagem:

• imagens que você envia para a sua conta, referenciadas como asset:<id>;
• imagens embutidas no HTML como URLs data:.

Nada mais carrega. Um <img> que aponta para um endereço da web é ignorado e reportado, porque o serviço nunca busca um endereço que esteja em um template.

Enviar

Envie um PNG ou JPEG no portal, em Images, ou pela API. O corpo da requisição é a imagem pura:

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
}

Use a reference como origem da imagem:

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

A referência também pode vir dos seus dados: <img src="{{ logo }}"> com "logo": "asset:0194f2c0-…".

Regras

• Só PNG e JPEG, até 5 MB cada. O tipo é verificado pelo próprio arquivo, não pelo nome.
• O seu plano limita o tamanho total das imagens; veja Planos e créditos.
• As imagens são privadas da sua conta. O id de uma imagem de outra conta não funciona nos seus documentos.
• Apague uma imagem com DELETE /v1/assets/{id}. Os documentos que ainda a referenciam são gerados sem ela.

URLs data

Para uma imagem pequena que muda a cada documento, como um QR code, embuta diretamente:

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

Imagens muito grandes ou de resolução muito alta são recusadas com um aviso, em vez de deixar a geração lenta.