prezentit

What this skill does

# Prezentit - AI Presentation Generator

Generate stunning presentations instantly with AI. Describe your topic and get a complete slide deck with custom designs.

## Quick Start

1. **Get API Key**: Sign in at [prezentit.net](https://prezentit.net) → Profile → API → Create Key
2. **Configure**: `/config set PREZENTIT_API_KEY pk_your_key_here`
3. **Generate**: "Create a presentation about sustainable energy"

## Features

- **40+ Themes**: Minimalist, Corporate, Creative, Nature, Tech, Education
- **AI-Designed Slides**: Each slide uniquely designed to match content  
- **External Outlines**: Provide your own outline to save credits (33% savings)
- **Direct Download**: Get your presentation link immediately

## Pricing

| Action | Credits |
|--------|---------|
| Outline (per slide) | 5 credits |
| Design (per slide) | 10 credits |
| **Total per slide** | **15 credits** |
| **With your outline** | **10 credits** (design only) |

New accounts: 100 free credits. Purchase more at [prezentit.net/buy-credits](https://prezentit.net/buy-credits)

## API Quick Reference

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

### Essential Endpoints

| Endpoint | Description |
|----------|-------------|
| `GET /me/credits` | Check your credit balance |
| `GET /themes` | List available themes |
| `GET /themes?search=NAME` | Find theme by name |
| `POST /presentations/generate` | Generate presentation |
| `GET /docs/outline-format` | **Get outline validation rules** |

### Generate Presentation

```json
POST /presentations/generate

{
  "topic": "Your topic (required)",
  "details": "Additional context (optional)",
  "slideCount": 5,           // 3-50, default: 5
  "theme": "minimalist",     // Theme ID from /themes
  "outline": { ... },        // Optional: provide your own outline
  "stream": false            // IMPORTANT: Set to false for AI agents
}
```

**CRITICAL for AI Agents**: Always set `"stream": false` to receive a single JSON response instead of Server-Sent Events (SSE). This prevents polling issues and rate limits.

**Response with `stream: false`**:
```json
{
  "success": true,
  "data": {
    "presentationId": "uuid",
    "title": "Your Presentation Title",
    "viewUrl": "https://prezentit.net/view/abc123...",
    "slideCount": 5,
    "creditsUsed": 75,
    "remainingCredits": 25
  }
}
```

**Theme Selection**: Either provide `theme` (from /themes) OR `customDesignPrompt` for custom styles.

### External Outlines (Save 33% Credits)

You can provide your own outline to skip AI outline generation. This is useful when:
- You have specific content requirements
- You want to save credits
- An external AI (like Clawdbot) generates the outline

**Get the exact format requirements**:
```bash
GET /api/v1/docs/outline-format
```

This endpoint returns:
- All validation constraints (min/max words, characters, slide counts)
- Required fields for each slide
- Example outline structure
- Error fix suggestions

**Important**: Presentations with external outlines cannot be shared to the community feed (but can have public view links).

### Example with External Outline

```json
{
  "topic": "Machine Learning Basics",
  "theme": "minimalist",
  "stream": false,
  "outline": {
    "slides": [
      {
        "title": "Introduction to Machine Learning",
        "mainIdea": "Machine learning enables computers to learn from data...",
        "talkingPoints": [
          "Definition and core principles",
          "How ML differs from traditional programming",
          "Key applications in everyday life"
        ],
        "visualGuide": "Split-screen comparison of traditional programming vs ML..."
      }
      // ... more slides
    ]
  }
}
```

### Error Handling

When outline validation fails, you'll receive detailed errors:

```json
{
  "error": "Invalid outline format",
  "code": "INVALID_OUTLINE",
  "validationErrors": [
    {
      "slide": 1,
      "field": "title",
      "error": "Title must be between 3-100 characters",
      "value": "ML",
      "fix": "Expand the title to at least 3 characters"
    }
  ],
  "constraints": { ... },
  "documentation": "https://prezentit.net/api/v1/docs/outline-format"
}
```

### Common Errors

| Code | Meaning |
|------|---------|
| 401 | Invalid/missing API key |
| 402 | Insufficient credits |
| 429 | Rate limited (retry after 60s) |

## Best Practices for Clawdbot

1. **ALWAYS use `stream: false`** - This is critical! Without it, you'll get SSE streaming which causes polling issues and rate limits
2. **Always check credits first** before generating
3. **Search themes** when user requests a specific style
4. **Use outline format endpoint** to get current validation rules before generating outlines
5. **Handle validation errors** - they include fix suggestions
6. **Inform user** about external outline restrictions (no community feed sharing)
7. **Don't poll** - With `stream: false`, the API returns a single JSON response when generation is complete

## Support

- **Website**: [prezentit.net](https://prezentit.net)
- **API Docs**: Call `GET /api/v1/docs/outline-format` for live documentation