Consulting Deck Workflow

One API call → finished consulting deck with narrative structure. The API generates a narrative outline with slide roles (hook, evidence, framework, recommendation), auto-selects the best template for each slide, renders in parallel, and compiles into a single PPTX.

How it works

Narrative planning — LLM creates a slide-by-slide outline with roles (hook, evidence, framework, recommendation, closing)
Template matching — each slide is matched to the best template or flagged for creative AI generation
Parallel rendering — up to 3 slides generated concurrently
Compilation — all slides merged into a single .pptx with consistent chrome and page numbers

Typically $0.30-$1.20 for 6 slides, 15-60s depending on slide count and complexity.

POST/v1/workflows/consulting-deck

Generate a complete consulting deck from a topic. Returns job_id — poll with GET /v1/jobs/{id} for per-slide progress and final pptx_url.

Parameters

Name	Type	Required	Description
topic	string	required	What the deck is about (min 10 chars). Be specific — include data points and framing.
audience	string	optional	Who will see this deck. Default: "executive leadership".
slide_count	integer	optional	Number of slides (2-20). Default: 6.
context	string	optional	Additional context — constraints, data, or background.
tone	string	optional	Narrative tone. Default: "consulting partner". E.g. "senior partner, opinionated".
theme_id	string	optional	Theme for all slides. Default: consulting_blue.
language	string	optional	Output language (ISO 639-1). Default: en.

Response

202

{
  "job_id": "cd-a1b2c3d4",
  "status": "generating",
  "name": "Cloud Migration Strategy",
  "narrative": [
    {
      "role": "hook",
      "brief": "The 3-year infrastructure cost trajectory is unsustainable"
    },
    {
      "role": "evidence",
      "brief": "Current vs projected spend: $2.4M → $4.8M by 2028"
    },
    {
      "role": "framework",
      "brief": "Migration readiness matrix: apps by complexity vs business criticality"
    },
    {
      "role": "evidence",
      "brief": "Case study: FinCo reduced infra costs 47% in 18 months"
    },
    {
      "role": "recommendation",
      "brief": "Phased migration plan: 3 waves over 12 months"
    },
    {
      "role": "closing",
      "brief": "Next steps and governance model"
    }
  ]
}

Examples

curl -X POST https://api.slideforge.dev/v1/workflows/consulting-deck \
  -H "Authorization: Bearer sf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Cloud migration strategy for a mid-size enterprise with $2.4M annual infra spend",
    "audience": "CTO and engineering leadership",
    "slide_count": 6,
    "tone": "senior partner, data-driven",
    "theme_id": "consulting_dark"
  }'

Narrative preview

The initial response includes a narrative array showing the planned slide-by-slide briefs, so you can see the arc before the deck finishes rendering. Each entry has a role (hook, evidence, framework, recommendation, closing) and a brief.