Visual TL;DR
POST/visual-tldr/generate1 credit

Visual TL;DR

Generate a flow-diagram Visual TL;DR for any article: interactive HTML with Quick / Explain / Deeper views, plus PNG, Markdown, and JSON-LD. Gemini-powered. Free tier always includes attribution footer; paid tiers can opt out. Bearer key or x402.

POSThttps://www.startuphub.ai/api/v1/visual-tldr/generate

Request

curl -X POST "https://www.startuphub.ai/api/v1/visual-tldr/generate" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"How AI agents buy software","content_html":"<p>Full article HTML...</p>"}'

Parameters

titlestringrequired

Article title.

content_htmlstringrequired

Full article HTML body.

excerptstringoptional

Optional excerpt for context.

source_urlstringoptional

Canonical URL (used in JSON-LD).

options.themestringoptional

default | midnight | cream | mint | slate

options.fontstringoptional

Font preset id (default, inter, editorial, ...).

options.include_attributionbooleanoptional

Footer branding (paid tiers only).

Response

json
{
  "success": true,
  "svg_html": "<div data-article-diagram=\"true\">...</div>",
  "html": "<div data-article-diagram=\"true\">...</div>",
  "image_url": "https://cdn.startuphub.ai/.../diagram.webp",
  "markdown": "# Visual TL;DR\n...",
  "jsonld": { "@type": "ImageObject" },
  "nodes_count": 8,
  "attribution_included": true,
  "plan": "pro_lite"
}

Errors

400Missing title or content_html
401Invalid or missing API key
429Monthly or daily visual_tldr quota exhausted
503Generation service unavailable