Prezentit

---
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. Get one at https://prezentit.net/api-keys
      example: |
        export PREZENTIT_API_KEY=pk_your_api_key_here
---

# Prezentit - AI Presentation Generator

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

## ⚠️ 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 pk_your_api_key_here

Response:

{
  "success": true,
  "data": {
    "credits": 100,
    "totalUsed": 0,
    "presentationsCreated": 0
  }
}

→ If not enough credits, tell user to buy at https://prezentit.net/buy-credits

Step 2: Find Theme (if user wants specific style)

GET /api/v1/themes?search=minimalist
Authorization: Bearer pk_your_api_key_here

Response:

{
  "success": true,
  "data": {
    "themes": [
      {
        "id": "theme_abc123",
        "name": "Clean Minimalist",
        "prompt": "Clean minimalist design with lots of white space...",
        "previewUrl": "https://..."
      }
    ]
  }
}

→ Use the id from results in step 3

Step 3: Generate Presentation

POST /api/v1/presentations/generate
Authorization: Bearer pk_your_api_key_here
Content-Type: application/json

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

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

Full Request Parameters:

Step 4: Get the Result

Success Response:

{
  "success": true,
  "data": {
    "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)

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

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

Pricing

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

Theme Selection Guide

Search by Keyword

GET /api/v1/themes?search=minimalist

Browse All Themes

GET /api/v1/themes

Theme Categories

Custom Theme (Skip the Search)

Instead of using a theme ID, provide a themePrompt:

{
  "topic": "AI in Healthcare",
  "themePrompt": "Modern medical theme with blue and white colors, clean typography, subtle DNA helix patterns in backgrounds",
  "stream": false
}

Good Theme Prompts Include:

• Color palette: "navy blue and gold accents"
• Style: "minimalist", "corporate", "playful"
• Visual elements: "geometric shapes", "gradients", "photography-based"
• Typography: "modern sans-serif", "elegant serif"
• Mood: "professional", "energetic", "calm"

Creating Outlines (Save 33% Credits)

Providing your own outline saves credits and gives you more control.

Outline Structure

{
  "topic": "Your Presentation Topic",
  "audience": "Who this is for",
  "purpose": "What you want to achieve",
  "slides": [
    {
      "type": "title",
      "title": "Main Title",
      "subtitle": "Optional Subtitle",
      "notes": "Speaker notes here"
    },
    {
      "type": "content",
      "title": "Slide Title",
      "bullets": ["Point 1", "Point 2", "Point 3"],
      "notes": "Speaker notes"
    }
  ]
}

Slide Types

Validation Rules

Overall:

• Minimum 1 slide, maximum 20 slides
• Topic: 2-500 characters
• First slide should typically be title type

Per Slide:

• Title: 1-200 characters, REQUIRED
• Subtitle: 1-150 characters (optional)
• Bullets: Array of strings, 3-7 recommended
• Each bullet: 1-300 characters
• Notes: 1-1000 characters (optional)

Complete Example

{
  "topic": "Introduction to Machine Learning",
  "outline": {
    "topic": "Introduction to Machine Learning",
    "audience": "Business executives",
    "purpose": "Explain ML basics and business applications",
    "slides": [
      {
        "type": "title",
        "title": "Introduction to Machine Learning",
        "subtitle": "Transforming Business with AI",
        "notes": "Welcome everyone. Today we'll explore how ML is revolutionizing business."
      },
      {
        "type": "content",
        "title": "What is Machine Learning?",
        "bullets": [
          "Subset of AI that learns from data",
          "Improves automatically through experience",
          "Powers recommendations, predictions, and automation"
        ],
        "notes": "Start with the basics - ML is about pattern recognition."
      },
      {
        "type": "section",
        "title": "Business Applications",
        "subtitle": "Real-World Use Cases"
      },
      {
        "type": "content",
        "title": "Key Applications",
        "bullets": [
          "Customer churn prediction",
          "Fraud detection",
          "Personalized recommendations",
          "Process automation"
        ]
      },
      {
        "type": "conclusion",
        "title": "Getting Started",
        "bullets": [
          "Identify high-impact use cases",
          "Start with clean, quality data",
          "Partner with ML experts"
        ],
        "notes": "End with actionable next steps."
      }
    ]
  },
  "theme": "theme_abc123",
  "stream": false
}

Get Schema Programmatically

GET /api/v1/docs/outline-format

Returns the full JSON schema for validation.

Error Handling

Error Response Format

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message",
    "retryAfter": 30
  }
}

Common Errors & Solutions

Handling Insufficient Credits

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "You need 75 credits but only have 50",
    "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 Rate Limits

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests",
    "retryAfter": 30
  }
}

AI Agent Action: Wait retryAfter seconds before retrying.

Additional Endpoints

Cancel Generation

POST /api/v1/presentations/{presentationId}/cancel
Authorization: Bearer pk_your_api_key_here

Only works while generation is in progress. Credits are refunded.

Get Presentation Details

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

Response:

{
  "success": true,
  "data": {
    "presentationId": "uuid",
    "status": "completed",
    "viewUrl": "https://prezentit.net/view/abc123",
    "createdAt": "2024-01-15T10:30:00Z",
    "slideCount": 5,
    "creditsUsed": 75
  }
}

List All Themes

GET /api/v1/themes
Authorization: Bearer pk_your_api_key_here

Optional query params:

• ?search=keyword - Filter by name/description
• ?category=corporate - Filter by category
• ?limit=20 - Limit results

Anti-Spam Rules

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

Quick Copy-Paste Examples

Minimal Generation

POST /api/v1/presentations/generate
{
  "topic": "Introduction to Climate Change",
  "stream": false
}

With Theme

POST /api/v1/presentations/generate
{
  "topic": "Q4 Sales Report",
  "slideCount": 8,
  "theme": "theme_corporate_blue",
  "stream": false
}

With Custom Theme

POST /api/v1/presentations/generate
{
  "topic": "Startup Pitch Deck",
  "slideCount": 10,
  "themePrompt": "Modern tech startup style with gradient backgrounds, bold typography, dark mode aesthetic",
  "stream": false
}

With Outline (33% Savings)

POST /api/v1/presentations/generate
{
  "outline": {
    "topic": "Team Meeting",
    "slides": [
      {"type": "title", "title": "Weekly Team Sync", "subtitle": "January 15, 2024"},
      {"type": "content", "title": "Accomplishments", "bullets": ["Completed feature X", "Fixed critical bugs", "Improved performance 20%"]},
      {"type": "content", "title": "This Week's Goals", "bullets": ["Launch beta", "User testing", "Documentation"]},
      {"type": "conclusion", "title": "Questions?", "bullets": ["Open discussion", "Next meeting: Monday 10am"]}
    ]
  },
  "theme": "theme_minimal",
  "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