n8n-nodes-headless-saas-infographics

An n8n community node for Headless SaaS — generate infographics, comics, cover images, social carousels, and slide decks directly inside your n8n workflows using your API key.

---

What this node does

The Headless SaaS node lets you call the Headless SaaS image generation API directly from n8n. Choose from five generation types, configure style and layout options, and receive ready-to-use image URL(s) along with your remaining credit balance.

Supported operations

Operation	Skill	Returns
Infographic	baoyu-infographic	Single image URL
Comic	baoyu-comic	Single image URL
Cover Image	baoyu-cover-image	Single image URL
XHS / Social Carousel	baoyu-xhs-images	Array of image URLs
Slide Deck	baoyu-slide-deck	Array of image URLs

---

Installation

Community node (recommended)

In your n8n instance, go to Settings → Community Nodes → Install and enter:

@itechnotion/n8n-nodes-headless-saas-infographics

Manual (npm)

npm install @itechnotion/n8n-nodes-headless-saas-infographics

Or with pnpm:

pnpm add @itechnotion/n8n-nodes-headless-saas-infographics

---

Getting an API key

1. Sign in to the Headless SaaS dashboard.
2. Navigate to API Keys in the sidebar.
3. Click Generate Key — your key will start with pxl_live_.
4. Copy the key and store it somewhere safe (it won't be shown again).

---

Credentials setup

1. In n8n, open Credentials → New Credential.
2. Search for Headless SaaS API.
3. Paste your pxl_live_... key into the API Key field.
4. Click Save — n8n will test the credential automatically.

---

Operations reference

---

1. Infographic (baoyu-infographic)

Automatically condenses textual content into highly scannable, visually structured maps and dashboards.

• Returns: imageUrl (Single Image)

{
  "skill": "baoyu-infographic",
  "content": "Your markdown or body text...",
  "user": "optional_user_tracking_label",
  "options": {
    "language": "en",
    "layout": "bento-grid",
    "style": "retro-pop-grid"
  }
}

Available layout options

bento-grid	binary-comparison	bridge	circular-flow
comic-strip	comparison-matrix	dashboard	dense-modules
funnel	hierarchical-layers	hub-spoke	iceberg
isometric-map	jigsaw	linear-progression	periodic-table
story-mountain	structural-breakdown	tree-branching	venn-diagram
winding-roadmap

Available style options

aged-academia	bold-graphic	chalkboard	claymation
corporate-memphis	craft-handmade	cyberpunk-neon	ikea-manual
kawaii	knolling	lego-brick	morandi-journal
origami	pixel-art	pop-laboratory	retro-pop-grid
storybook-watercolor	subway-map	technical-schematic	ui-wireframe

---

2. Comic (baoyu-comic)

Converts any story or educational content into a hand-drawn knowledge comic panel.

• Returns: imageUrl (Single Image)

{
  "skill": "baoyu-comic",
  "content": "Story content...",
  "options": {
    "language": "en",
    "art": "ligne-claire",
    "tone": "dramatic",
    "layout": "splash",
    "aspectRatio": "3:4"
  }
}

aspectRatio options: 3:4, 4:3, 16:9, 1:1

Available art (Art Styles)

chalk · ink-brush · ligne-claire · manga · realistic

Available tone (Emotional Tones)

action · dramatic · energetic · neutral · romantic · vintage · warm

Available layout (Panel Layouts)

cinematic · dense · mixed · splash · standard · webtoon

---

3. Cover Image (baoyu-cover-image)

Generates a hero/cover image optimised for a blog post or landing page header.

• Returns: imageUrl (Single Image)

{
  "skill": "baoyu-cover-image",
  "content": "Article body...",
  "options": {
    "language": "en",
    "type": "hero",
    "palette": "cool",
    "rendering": "flat-vector",
    "mood": "balanced",
    "textDensity": "title-subtitle",
    "aspectRatio": "16:9"
  }
}

mood options: subtle, balanced, bold
textDensity options: none, title-only, title-subtitle, text-rich
aspectRatio options: 16:9, 4:3, 1:1, 9:16

Available type (Layout Types)

hero · conceptual · typography · metaphor · scene · minimal

Available palette (Color Palettes)

cool · dark · earth · elegant · mono · pastel · retro · vivid · warm

Available rendering (Visual Style)

chalk · digital · flat-vector · hand-drawn · painterly · pixel

---

4. XHS / Social Carousel (baoyu-xhs-images)

Generates an array of engaging, vertical carousel pages optimised for modern social media.

• Returns: imageUrls (Array of Images)

{
  "skill": "baoyu-xhs-images",
  "content": "Content to transform into swipeable carousel...",
  "options": {
    "language": "en",
    "style": "notion",
    "layout": "canvas",
    "aspectRatio": "3:4"
  }
}

aspectRatio options: 3:4, 4:3, 1:1, 9:16

Available style (Visual Presets)

bold · chalkboard · cute · fresh · minimal · notion · pop · retro · study-notes · warm

Available layout (Information Hierarchy)

canvas · decorations · image-effects · typography

---

5. Slide Deck (baoyu-slide-deck)

Automatically generates a complete business presentation deck composed of multiple distinct slides.

• Returns: imageUrls (Array of Images)

{
  "skill": "baoyu-slide-deck",
  "content": "Quarterly overview bullet points...",
  "options": {
    "language": "en",
    "style": "corporate",
    "aspectRatio": "16:9"
  }
}

aspectRatio options: 16:9, 4:3, 1:1

Available style (Presentation Designs)

blueprint	bold-editorial	chalkboard	corporate
dark-atmospheric	editorial-infographic	fantasy-animation	intuition-machine
minimal	notion	pixel-art	scientific
sketch-notes	vector-illustration	vintage	watercolor

---

Intelligent Auto-Selection (AI Director)

If you are unsure which style, palette, or layout to use, simply omit those keys from your options object. The API will automatically run a preliminary Gemini Agent query to intelligently scan all available options and pick the best stylistic combination based on your content.

---

Node output fields

Field	Description
success	true if generation succeeded
operation	The operation used (e.g. infographic)
skill	The skill string passed to the API
imageUrls	Array of all generated image URLs
firstImageUrl	Shortcut to the first image URL
imageUrl	Alias for the first image URL (single-image operations)
creditsRemaining	Credits remaining after this call

Cost: 1 credit per call.

---

Example workflow

[Manual Trigger]
      ↓
[Set node]
  content = "A comparison of top 5 programming languages in 2025"
      ↓
[Headless SaaS — Infographic]
  Layout: bento-grid
  Style:  bold-graphic
      ↓
[Send Email / HTTP Request — use firstImageUrl]

1. Add a Manual Trigger node.
2. Add a Set node to define your content (or pass it from a previous step).
3. Add the Headless SaaS node, select an operation, configure style options, and connect your credential.
4. Run the workflow — the output will contain firstImageUrl (or imageUrls for multi-image operations) ready to use downstream.

---

Error handling

HTTP status	Meaning
401	Invalid or missing API key
402	Insufficient credits — top up your pack
400	Missing skill or content field
502	Generation failed upstream — retry
503	Service temporarily unavailable

Enable Continue On Fail on the node to handle errors gracefully in your workflow.

---

Supported languages

Code	Language
en	English
zh	Chinese
es	Spanish
fr	French
de	German
ja	Japanese
ko	Korean
pt	Portuguese

---

Local development

# Build the node
pnpm run build

# Link into your local n8n custom nodes directory
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm install /absolute/path/to/n8n-nodes-headless-saas-infographics

# Start n8n
n8n start

Then search for Headless SaaS in the node panel.

---

License

MIT © Avkash Kakdia