html-to-image v1.0.0

J5Soft · ferramentas · Chromium Chromium 152.0.7977.82 built on Debian GNU/Linux 13 (trixie)

HTML entra, imagem sai. Direto no node do n8n.

Serviço de renderização headless: envie o HTML gerado pelo seu agente e receba o arquivo final pronto (PNG, JPEG ou WebP) — no tamanho exato dos presets de redes sociais.

POST https://html-to-image.5.189.186.144.sslip.io/render

exemplo rápido

curl -X <span class="k">POST</span> https://html-to-image.5.189.186.144.sslip.io/render \
  -H <span class="k">'X-API-Key: SUA_CHAVE'</span> \
  -H <span class="k">'Content-Type: application/json'</span> \
  -d <span class="k">'{"html": "<div style='</span><span class="k">'padding:64px;font:700 72px sans-serif'</span><span class="k">'>Olá J5Soft</div>", "preset": "square"}'</span> \
  -o post.png

Endpoints

Autenticação por API key: header X-API-Key, Authorization: Bearer … ou ?key=.

POST /render

Recebe {"html": "…"} e devolve a imagem. Resposta binária por padrão; com "base64": true devolve JSON.

GET /health

Status do serviço, versão do Chromium e carga atual. Usado no healthcheck do Coolify.

GET /presets

Lista os tamanhos prontos: square, story, portrait, og, twitter, linkedin, youtube.

GET /

Esta página de documentação.

Parâmetros do render

Todos opcionais, exceto html. Podem ir no corpo JSON ou na query string.

campo	padrão	descrição
`html`	—	HTML completo ou fragmento. Cercas ```html e prosa antes/depois do documento que o agente costuma devolver são removidas automaticamente.
`preset`	`square`	Tamanho pronto (ver `/presets`).
`width` / `height`	1080 / 1080	Dimensões em px. Use `"height": "auto"` para altura livre (recorta o excesso).
`scale`	`1`	Fator de escala do dispositivo (2 = retina, arquivo maior).
`format`	`png`	`png`, `jpeg` ou `webp`.
`quality`	`92`	Qualidade para jpeg/webp.
`background`	`#ffffff`	Cor de fundo do canvas (hex).
`transparent`	`false`	Fundo transparente (png/webp).
`trim`	`false`	Recorta margens vazias ao redor do conteúdo.
`waitMs`	`1500`	Tempo de espera para fontes, imagens e animações antes de capturar.
`css`	—	CSS extra injetado no documento (ajustes finos sem mexer no HTML). Entra fora da camada, portanto vence o CSS do documento.
`inject`	`true`	O reset de CSS da app entra em `@layer hti-reset`: por regra do cascade, o CSS do seu HTML (fora de camadas) sempre vence o reset.
`base64`	`false`	Devolve JSON com a imagem em base64 em vez do binário.
`noNetwork`	`false`	Bloqueia DNS durante o render (determinismo e segurança).

Como usar no n8n

No fim do workflow, depois do node do agente que devolve o HTML.

HTTP RequestMethod POST, URL https://html-to-image.5.189.186.144.sslip.io/render.
HeadersAdicione X-API-Key com o valor da sua chave.
Body → JSON{"html": "{{ $json.html }}", "preset": "square", "scale": 1}
Options → ResponseResponse Format: File, Put Output in Field: data — o node passa a entregar o arquivo em binário.
PublicarUse o binário data no próximo node (upload, WhatsApp, e-mail, Drive, etc.).

body do node HTTP Request

{
  "html": "{{ $json.html }}",
  "preset": "square",
  "scale": 1,
  "format": "png"
}

Respostas e erros

status	code	quando acontece
200	—	Imagem gerada (headers `X-Image-Width`, `X-Image-Height`, `X-Render-Ms`).
400	`bad_request`	Parâmetro inválido (preset, formato, cor, dimensão).
401	`unauthorized`	API key ausente ou incorreta.
413	`html_too_large`	HTML acima de 2.000.000 bytes.
429	`busy`	Fila cheia — repita a chamada em alguns segundos.
500	`render_failed`	Falha do Chromium (informe o `detail` ao suporte).
504	`render_timeout`	Render passou de 60s.