Prezentit

Generate beautiful AI-powered presentations instantly. Create professional slides with custom themes, visual designs, and speaker notes—all through natural language commands.

skill

---
name: prezentit
description: Generate beautiful AI-powered presentations instantly. Create professional slides with custom themes, visual designs, and speaker notes—all through natural language commands.
homepage: https://prezentit.net
emoji: "👽"
metadata:
  clawdbot:
    emoji: "👽"
    skillKey: prezentit
    homepage: https://prezentit.net
    requires:
      config:
        - PREZENTIT_API_KEY
    config:
      requiredEnv:
        - name: PREZENTIT_API_KEY
          description: Your Prezentit API key (starts with pk_). Get one free at https://prezentit.net/api-keys
      example: |
        export PREZENTIT_API_KEY=pk_your_api_key_here
    permissions:
      network:
        - https://prezentit.net/api/v1/*
      fileSystem: none
      env:
        reads:
          - PREZENTIT_API_KEY
        writes: none
---

# Prezentit - AI Presentation Generator

**Base URL**: `https://prezentit.net/api/v1`
**Auth Header**: `Authorization: Bearer {PREZENTIT_API_KEY}`

> **This skill requires a `PREZENTIT_API_KEY` environment variable.** Get a free API key at https://prezentit.net/api-keys — new accounts include 100 free credits.

## ⚠️ CRITICAL FOR AI AGENTS

**ALWAYS use `"stream": false`** in generation requests! Without this, you get streaming responses that cause issues.

---

## Complete Workflow (FOLLOW THIS ORDER)

### Step 1: Check Credits First

```http
GET /api/v1/me/credits
Authorization: Bearer {PREZENTIT_API_KEY}

Response:

json

{
  "credits": 100,
  "pricing": {
    "outlinePerSlide": 5,
    "designPerSlide": 10,
    "estimatedCostPerSlide": 15
  },
  "_ai": {
    "canGenerate": true,
    "maxSlidesAffordable": 6,
    "nextSteps": ["..."]
  }
}

→ If _ai.canGenerate is false, direct user to https://prezentit.net/buy-credits → Use _ai.maxSlidesAffordable to know the limit

Step 2: Choose a Theme

Option A — Browse all available themes and pick by ID:

http

GET /api/v1/themes
Authorization: Bearer {PREZENTIT_API_KEY}

Response:

json

{
  "themes": [
    { "id": "corporate_blue", "name": "Corporate Blue", "category": "Corporate & Professional" },
    { "id": "nature_earth", "name": "Nature Earth", "category": "Nature & Organic" }
  ],
  "categories": ["Corporate & Professional", "Creative & Visual", "Data & Analytics", ...],
  "_ai": {
    "totalThemes": 20,
    "popularThemes": ["corporate_blue", "midnight_tech", "nature_earth", "storyteller", "data_dashboard"]
  }
}

→ Use the exact id value in your generation request

Option B — Search for a theme by keyword:

http

GET /api/v1/themes?search=minimalist
Authorization: Bearer {PREZENTIT_API_KEY}

→ Returns best matches ranked by relevance. Use the id from bestMatch.

Option C — Describe a custom style (no theme ID needed):

Use the customDesignPrompt parameter instead. See the Custom Design Prompt section below.

Step 3: Generate Presentation

http

POST /api/v1/presentations/generate
Authorization: Bearer {PREZENTIT_API_KEY}
Content-Type: application/json

{
  "topic": "User's topic here",
  "slideCount": 5,
  "theme": "corporate_blue",
  "stream": false
}

⏱️ IMPORTANT: Generation takes 1-3 minutes. The API will return when complete.

Full Request Parameters:

Parameter	Type	Required	Description
topic	string	Yes*	Presentation topic (2-500 chars). Required if no outline. prompt is also accepted as an alias.
outline	object	No	Pre-built outline (saves ~33% credits). See Outline section below.
slideCount	number	No	Number of slides (3-50, default: 5). Ignored if outline provided.
theme	string	No	Theme ID from GET /api/v1/themes. Use the exact id value.
customDesignPrompt	string	No	Custom visual style description (see below). Overrides theme ID.
details	string	No	Additional context about the presentation content.
confirmPartial	boolean	No	Set true to confirm partial generation when credits are limited.
stream	boolean	ALWAYS false	AI agents must always set stream: false.

*topic is required even when providing an outline (used for presentation metadata).

Step 4: Get the Result

Success Response:

json

{
  "presentationId": "uuid-here",
  "viewUrl": "https://prezentit.net/view/abc123",
  "creditsUsed": 75,
  "remainingCredits": 25
}

→ Share the viewUrl with the user. That's their presentation!

Step 5: Download (Optional)

http

GET /api/v1/presentations/{presentationId}/download?format=pptx
Authorization: Bearer {PREZENTIT_API_KEY}

Formats: pptx (PowerPoint), pdf, json (raw data)

---

Pricing

Scenario	Cost per Slide	Example (5 slides)
Auto-generate outline	15 credits	75 credits
Provide your own outline	10 credits	50 credits (~33% savings!)

• New accounts get 100 free credits
• Buy more at: https://prezentit.net/buy-credits

---

Theme Selection

How to Pick a Theme

1. Fetch the theme list: GET /api/v1/themes — returns all available themes with id, name, and category
2. Pick the best match for the user's topic and style preference
3. Pass the id in the generation request as the theme parameter

You can also search: GET /api/v1/themes?search=KEYWORD or filter by category: GET /api/v1/themes?category=CATEGORY_NAME

Custom Design Prompt (Skip the Theme List)

If no existing theme fits, use customDesignPrompt to describe a fully custom visual style. This must be a detailed, structured description — not just a color palette.

REQUIRED structure for customDesignPrompt (include ALL of these sections):

text

COLOR SYSTEM: Primary [hex], secondary [hex], accent [hex], background [hex/gradient], text colors for headings and body.

TYPOGRAPHY: Heading font style [e.g., bold geometric sans-serif like Montserrat], body font style [e.g., clean humanist sans-serif like Open Sans], size hierarchy [large/medium/small], weight contrast.

LAYOUT SYSTEM: Slide structure [e.g., asymmetric split with 60/40 content-to-visual ratio], alignment [left-aligned text with right visual panel], spacing philosophy [generous whitespace vs. dense information], grid approach.

VISUAL ELEMENTS: Background treatment [solid/gradient/textured/patterned], decorative motifs [geometric shapes, organic curves, line art, etc.], image style [photography with overlay, illustrations, icons, data visualizations], border/frame treatments.

MOOD & TONE: Overall aesthetic [e.g., corporate authority, playful creativity, academic rigor, tech-forward], energy level [calm/dynamic/bold], intended audience impression.

Example — Good customDesignPrompt:

json

{
  "topic": "AI in Healthcare",
  "customDesignPrompt": "COLOR SYSTEM: Primary deep medical blue (#1B3A5C), secondary teal (#2A9D8F), accent warm coral (#E76F51) for callouts, backgrounds alternate between clean white (#FAFAFA) and very subtle blue-gray (#F0F4F8), heading text dark navy, body text #333333. TYPOGRAPHY: Headings in bold geometric sans-serif (Montserrat style), body in clean humanist sans (Source Sans style), strong size hierarchy with 48pt titles, 24pt subtitles, 16pt body. LAYOUT SYSTEM: Asymmetric layouts with 60/40 content-to-visual split, left-aligned text blocks with right-side data visualizations or medical imagery, generous padding (60px margins), clean grid structure. VISUAL ELEMENTS: Subtle DNA helix watermark in corners at 5% opacity, thin teal accent lines as section dividers, medical iconography (stethoscope, heartbeat, molecular structures) as small decorative elements, photography with blue-tinted overlay for full-bleed backgrounds. MOOD & TONE: Professional medical authority balanced with approachable warmth, calm and trustworthy, designed for hospital executives and medical professionals.",
  "stream": false
}

Example — Bad customDesignPrompt (TOO VAGUE, will produce generic results):

text

"blue and white medical theme"

---

Creating Outlines (Save ~33% Credits)

Providing your own outline saves credits and gives you full control over content.

Outline Structure

The outline is an object with a slides array. Each slide has these fields:

json

{
  "topic": "Your Presentation Topic",
  "outline": {
    "slides": [
      {
        "title": "Slide Title Here",
        "mainIdea": "A clear sentence explaining the core message of this slide and what the audience should take away from it.",
        "talkingPoints": [
          "First key point with enough detail to be meaningful (at least 10 characters)",
          "Second key point expanding on the main idea",
          "Third key point providing supporting evidence or examples"
        ],
        "visualGuide": "Detailed description of the visual layout: background style, image placement, icon suggestions, chart types, color emphasis areas, and decorative elements for this specific slide."
      }
    ]
  },
  "stream": false
}

Slide Field Reference

Field	Required	Constraints	Description
title	Yes	3-100 chars, 1-15 words	Slide heading
mainIdea	Yes	10-500 chars, 3-75 words	Core message of the slide
talkingPoints	Yes	2-7 items, each 10-300 chars (3-50 words)	Key points to cover
visualGuide	Yes	20-500 chars, 5-75 words	Visual design instructions for this slide

Validation Rules

Overall:

• Minimum 3 slides, maximum 50 slides
• topic is still required (used for presentation metadata)
• All four fields (title, mainIdea, talkingPoints, visualGuide) are required per slide

The API returns detailed error messages with fix suggestions if validation fails.

Complete Example

json

{
  "topic": "Introduction to Machine Learning",
  "outline": {
    "slides": [
      {
        "title": "Introduction to Machine Learning",
        "mainIdea": "Machine learning is transforming how businesses operate by enabling systems to learn from data and improve automatically without explicit programming.",
        "talkingPoints": [
          "Machine learning is a subset of artificial intelligence focused on pattern recognition",
          "ML systems improve through experience rather than manual rule-writing",
          "Global ML market projected to reach $209 billion by 2029"
        ],
        "visualGuide": "Bold title slide with futuristic tech aesthetic. Dark gradient background transitioning from deep navy to midnight blue. Large bold title text centered with a subtle neural network node pattern behind it. Accent glow in electric blue."
      },
      {
        "title": "How Machine Learning Works",
        "mainIdea": "Machine learning algorithms are categorized into supervised, unsupervised, and reinforcement learning based on how they learn from data.",
        "talkingPoints": [
          "Supervised learning uses labeled data for classification and regression tasks",
          "Unsupervised learning discovers hidden patterns in unlabeled data through clustering",
          "Reinforcement learning optimizes decisions through trial, error, and reward signals"
        ],
        "visualGuide": "Three distinct visual sections showing each ML type with representative icons: labeled data pairs for supervised, clustered groups for unsupervised, and a game-like reward loop for reinforcement. Use consistent color coding with blue, green, and purple."
      },
      {
        "title": "Business Applications",
        "mainIdea": "Companies across industries are leveraging machine learning for competitive advantage in customer experience, operations, and decision-making.",
        "talkingPoints": [
          "Customer churn prediction reduces revenue loss by identifying at-risk accounts early",
          "Fraud detection systems process millions of transactions in real-time",
          "Personalized recommendation engines drive significant increases in engagement and sales"
        ],
        "visualGuide": "Clean content layout with left-aligned text and right-side icons or mini-charts for each application. Use a white background with subtle grid lines. Each talking point gets a small illustrative icon (shield for fraud, chart for prediction, user icon for personalization)."
      },
      {
        "title": "Getting Started with ML",
        "mainIdea": "Successful ML adoption requires starting with clear use cases, quality data, and the right team rather than jumping straight to complex algorithms.",
        "talkingPoints": [
          "Identify high-impact use cases where prediction or automation adds clear value",
          "Invest in clean, well-structured data before selecting algorithms",
          "Build or partner with ML expertise and start with proven frameworks"
        ],
        "visualGuide": "Conclusion slide with a numbered roadmap or step layout. Three large numbered circles (1, 2, 3) each containing a step. Background with subtle upward-pointing arrows suggesting progress. Call-to-action feel with bold accent color on the final step."
      }
    ]
  },
  "theme": "midnight_tech",
  "stream": false
}

Get Schema Programmatically

http

GET /api/v1/docs/outline-format
Authorization: Bearer {PREZENTIT_API_KEY}

Returns the full JSON schema with all constraints and example slides.

---

Error Handling

Error Response Format

json

{
  "error": "Human readable message",
  "code": "ERROR_CODE",
  "fix": "Guidance on how to resolve this"
}

Common Errors & Solutions

HTTP	Code	Message	Solution
400	MISSING_TOPIC	Topic or prompt is required	Provide a topic or prompt field
400	INVALID_OUTLINE	Outline validation failed	Check outline structure — response includes detailed validationErrors with fix per field
400	INVALID_SLIDE_COUNT	Slide count must be 3-50	Adjust slideCount to be between 3 and 50
401	UNAUTHORIZED	Invalid or missing API key	Check Authorization: Bearer pk_... header
402	INSUFFICIENT_CREDITS	Not enough credits	Response includes required, available, and purchaseUrl
404	PRESENTATION_NOT_FOUND	Presentation doesn't exist	Verify presentation ID
409	DUPLICATE_REQUEST	Same request within cooldown	Wait and retry — don't resend identical requests
409	GENERATION_IN_PROGRESS	Already generating	Check status at GET /api/v1/me/generation/status or cancel at POST /api/v1/me/generation/cancel
429	RATE_LIMITED	Too many requests	Wait retryAfter seconds before retrying
500	GENERATION_FAILED	Internal error	Retry once, then contact support
503	SERVICE_UNAVAILABLE	System overloaded	Retry after retryAfter seconds

Handling Insufficient Credits

json

{
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS",
  "required": 75,
  "available": 50,
  "purchaseUrl": "https://prezentit.net/buy-credits"
}

AI Agent Response: "You need 75 credits but only have 50. Purchase more at https://prezentit.net/buy-credits"

Handling Partial Generation

If the user has some credits but not enough for full generation, the API returns a confirmation_required response with options. Read the _ai.options array and present them to the user. To proceed with partial generation, resend the request with "confirmPartial": true.

Handling Rate Limits

json

{
  "error": "Too many requests",
  "code": "RATE_LIMITED",
  "retryAfter": 30
}

AI Agent Action: Wait retryAfter seconds before retrying.

---

Additional Endpoints

Check Generation Status

http

GET /api/v1/me/generation/status
Authorization: Bearer {PREZENTIT_API_KEY}

Returns current progress if a generation is running: stage, percentage, designs completed.

Cancel Active Generation

http

POST /api/v1/me/generation/cancel
Authorization: Bearer {PREZENTIT_API_KEY}

Cancels the current generation in progress.

Get Presentation Details

http

GET /api/v1/presentations/{presentationId}
Authorization: Bearer {PREZENTIT_API_KEY}

List User's Presentations

http

GET /api/v1/me/presentations
Authorization: Bearer {PREZENTIT_API_KEY}

Optional: ?limit=20&offset=0

List All Themes

http

GET /api/v1/themes
Authorization: Bearer {PREZENTIT_API_KEY}

Optional query params:

• ?search=keyword — Filter by name
• ?category=corporate — Filter by category

---

Anti-Spam Rules

Rule	Limit	What Happens
Duplicate detection	~30 seconds	409 error for identical requests
Rate limit	Varies by key	429 error with retryAfter
One generation at a time	1 concurrent	409 GENERATION_IN_PROGRESS error

Best Practice: Always check for retryAfter in error responses and wait that duration.

---

Quick Copy-Paste Examples

Minimal Generation

json

POST /api/v1/presentations/generate

{
  "topic": "Introduction to Climate Change",
  "stream": false
}

With Theme (Fetch ID First)

text

1. GET /api/v1/themes → find the theme ID
2. POST /api/v1/presentations/generate

json

{
  "topic": "Q4 Sales Report",
  "slideCount": 8,
  "theme": "corporate_blue",
  "stream": false
}

With Custom Design Prompt

json

{
  "topic": "Startup Pitch Deck",
  "slideCount": 10,
  "customDesignPrompt": "COLOR SYSTEM: Primary electric indigo (#4F46E5), secondary cyan (#06B6D4), accent hot pink (#EC4899), background dark charcoal (#111827) with subtle radial gradient to #1F2937, heading text white, body text #D1D5DB. TYPOGRAPHY: Headings in extra-bold wide-tracking sans-serif (Inter/Poppins style), body in medium-weight clean sans, dramatic size contrast with 56pt titles and 18pt body. LAYOUT SYSTEM: Full-bleed dark slides with asymmetric content placement, bold left-aligned headlines with supporting text below, large visual areas for mockups and charts, 80px margins. VISUAL ELEMENTS: Subtle dot grid pattern at 3% opacity on backgrounds, neon-glow accent lines, rounded corners on all containers, glassmorphism cards with frosted backgrounds for data callouts, gradient mesh blobs as decorative elements. MOOD & TONE: Bold tech-startup energy, confident and forward-looking, designed to impress venture capital investors.",
  "stream": false
}

With Outline (~33% Savings)

json

{
  "topic": "Weekly Team Sync",
  "outline": {
    "slides": [
      {
        "title": "Weekly Team Sync",
        "mainIdea": "Kickoff slide for the January 15, 2024 weekly team synchronization meeting covering accomplishments and upcoming goals.",
        "talkingPoints": [
          "Welcome the team and set the agenda for today's sync",
          "Cover last week's wins and this week's priorities"
        ],
        "visualGuide": "Clean title slide with company colors. Bold centered title, date as subtitle below. Simple professional background with subtle geometric pattern."
      },
      {
        "title": "Last Week's Accomplishments",
        "mainIdea": "The team delivered significant progress across feature development, bug resolution, and performance optimization last week.",
        "talkingPoints": [
          "Feature X completed and merged into the main branch ahead of schedule",
          "Resolved three critical production bugs affecting checkout flow",
          "Database query optimization improved page load times by twenty percent"
        ],
        "visualGuide": "Content slide with checkmark icons next to each accomplishment. Green accent color for completed items. Left-aligned text with small celebration graphic in the corner."
      },
      {
        "title": "This Week's Goals",
        "mainIdea": "This week focuses on the beta launch, initial user testing, and completing documentation before the public release.",
        "talkingPoints": [
          "Launch beta version to internal testers by Wednesday",
          "Conduct user testing sessions with five pilot customers",
          "Complete API documentation and developer onboarding guide"
        ],
        "visualGuide": "Forward-looking slide with numbered steps or timeline visual. Blue accent color for upcoming items. Arrow or roadmap graphic showing progression from current state to launch."
      },
      {
        "title": "Open Discussion",
        "mainIdea": "Time for team questions, blockers, and any items not covered in the structured agenda.",
        "talkingPoints": [
          "Open floor for questions and discussion of blockers",
          "Next sync meeting scheduled for Monday at ten AM"
        ],
        "visualGuide": "Simple closing slide with question mark icon or discussion bubble graphic. Calm colors, minimal text, large font for the key info. Meeting time prominently displayed."
      }
    ]
  },
  "theme": "corporate_blue",
  "stream": false
}

---

Getting Help

• Website: https://prezentit.net
• Buy Credits: https://prezentit.net/buy-credits
• Support: https://prezentit.net/support
• API Key Management: https://prezentit.net/api-keys

text