POST
/visual-tldr/generate1 creditVisual 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
titlestringrequiredArticle title.
content_htmlstringrequiredFull article HTML body.
excerptstringoptionalOptional excerpt for context.
source_urlstringoptionalCanonical URL (used in JSON-LD).
options.themestringoptionaldefault | midnight | cream | mint | slate
options.fontstringoptionalFont preset id (default, inter, editorial, ...).
options.include_attributionbooleanoptionalFooter 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_html401Invalid or missing API key429Monthly or daily visual_tldr quota exhausted503Generation service unavailable