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 (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

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

**Response:**

{ "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:**

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

**Response:**

{ "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:**

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

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:**

{ "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 {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):

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:**

{ "topic": "AI in Healthcare",

...