Slides guide

​

What the Slides agent can do

• Multi-slide decks with a cohesive theme — the agent picks a color palette, accent color, type scale, and spacing system once and applies it consistently across every slide.
• Rich layouts — hero / title slides, agenda slides, two-column and three-column content, KPI / big-number cards, comparison matrices, quote breaks, thank-you closers. The agent picks the right layout per slide based on what the content is doing.
• Data visualizations — column / bar / line / pie / combo / donut / scatter / timeline / roadmap charts with the deck’s accent color; KPI cards with prominent numbers; process flowcharts and pyramid / funnel diagrams.
• Tables on slides — headed tables, shaded rows, per-cell borders and alignment; great for feature comparisons and metrics breakdowns.
• Text styling per shape — font family, size, weight, color, alignment, line height; bold and italic runs inline; bulleted and numbered lists.
• Backgrounds — solid color, gradient (linear or radial), or uploaded image; per-slide override so hero and section-break slides can differ from content slides.
• Speaker notes — the agent writes presenter notes per slide when the prompt asks for them; notes travel with the .pptx and appear in PowerPoint / Keynote / Google Slides presenter view.
• Images and icons — embed uploaded assets sized and positioned to the layout; re-use the same image across multiple slides.
• Shapes and callouts — rectangles, circles, arrows, connectors, process-flow shapes — positioned precisely with x/y/width/height.
• Slide-level actions — insert, replace, duplicate, delete, or reorder specific slides in an existing deck (via follow-up calls with the same run_id).
• Outline-first drafting — produce just the slide titles and bullets via POST /slides/outline for preview / approval before committing to a full deck build.

​

Quickstart

resp = requests.post(
    f"{API}/slides/generate",
    headers={"X-API-Key": KEY},
    json={
        "prompt": (
            "10-slide Q3 investor update for our SaaS company. "
            "Focus: MRR growth, churn reduction, Q4 roadmap. "
            "Visual style: clean, minimal, dark navy accents."
        ),
    },
)

​

Presentation modes

​

Working with images

hero = requests.post(
    f"{API}/images", headers=headers,
    files={"file": open("hero.png", "rb")},
    data={"caption": "Q3 hero", "tags": '["hero"]'},
).json()

product = requests.post(
    f"{API}/images", headers=headers,
    files={"file": open("dashboard.png", "rb")},
    data={"tags": '["product", "screenshot"]'},
).json()

resp = requests.post(f"{API}/slides/generate", headers=headers, json={
    "prompt": "10-slide pitch deck with product screenshots",
    "image_assets": [
        {"image_id": hero["image_id"], "tags": ["hero"]},
        {"image_id": product["image_id"], "tags": ["product"]},
    ],
})

​

Brand customization

resp = requests.post(f"{API}/slides/generate", headers=headers, json={
    "prompt": "10-slide pitch deck on Series B round",
    "brand": {
        "primary_color": "#2E75B6",
        "font": "Inter",
        "logo_url": "https://cdn.acme.com/logo.svg",
    },
    "image_assets": [...],
})

​

Editing existing decks

upload = requests.post(
    f"{API}/files", headers=headers,
    files={"file": open("deck_draft.pptx", "rb")},
    data={"purpose": "init"},
).json()

resp = requests.post(f"{API}/slides/generate", headers=headers, json={
    "prompt": "Replace slide 3 with a KPI summary showing three metric cards",
    "init_file": upload["file_id"],
})

​

Outline-only generation

resp = requests.post(f"{API}/slides/outline", headers=headers, json={
    "prompt": "10-slide Series B pitch deck",
    "slide_count_hint": 10,
})
# → {"outline": [{"title": "...", "bullets": [...]}, ...]}

​

Slide types

• Hero — dark / accent background, bold headline. Opening and closing slides default to this.
• Content — white/light background, 3–5 bullets max, consistent type.
• Section break — gradient tint, big section title, transitions between major chapters.

​

Things the agent handles well

• Cohesive palette — one industry preset (finance, tech, healthcare, etc.) per deck. Inherited by every slide.
• Chart-led proof slides — market size, traction, comparison matrices.
• Split-panel layouts — image left, text right (or vice versa).
• Sticky type scale — headline, body, caption — applied uniformly.
• Contrast rules — text on dark backgrounds is always light, and vice versa. Never invisible.

​

Things to be aware of

• Image search is not available in API mode. Upload what you want to use. The agent won’t search the web for images.
• Max slide count: 30 per call. Larger decks should be built in chunks via run_id resume — each follow-up call costs only a fraction of the first because the agent remembers the deck’s style.
• Speaker notes are supported — the agent writes them into the notes pane of each slide when your prompt asks for them (e.g. “add speaker notes under each slide for the presenter”). They travel with the .pptx and show up in PowerPoint / Keynote / Google Slides presenter view.
• Pattern selection is agent-driven. Describe the layout you want in your prompt (“use a three-column comparison on slide 4”, “make slide 7 a big-number KPI card”); the agent matches to the closest supported pattern.