Slide Count - Poesius API Documentation

Specifying Slide Count

You can control the number of slides in several ways:

REST API

curl -X POST "https://poe.poesius.com/api/v1/slides/generate-from-doc" \
  -H "X-API-Key: pk_your_api_key" \
  -F "document=@document.pdf" \
  -F "num_slides=15"

MCP

{
  "method": "tools/call",
  "params": {
    "name": "generate_slides",
    "arguments": {
      "topic": "My Presentation",
      "instructions": "Create slides",
      "num_slides": 15
    }
  }
}

Behavior

Default: If not specified, the system will auto-determine based on content
Exact Count: The system will attempt to create exactly the specified number of slides
Content-Based: The actual number may vary slightly based on content structure
Minimum: Typically 1 slide minimum
Maximum: Depends on your plan limits

Best Practices

Short Presentations

5-10 slides for:

Quick updates
Status reports
Brief overviews
Executive summaries

Standard Presentations

15-20 slides for:

Typical business presentations
Product demos
Team meetings
Standard reports

Comprehensive Presentations

25-30+ slides for:

Detailed topics
Training materials
Comprehensive reports
Educational content

Document-Based

For document-based generation:

Let the system determine based on document length, OR
Specify a target range (e.g., 15-20 slides)

Examples

Short Presentation

{
  "method": "tools/call",
  "params": {
    "name": "generate_slides",
    "arguments": {
      "topic": "Weekly Update",
      "instructions": "Create a brief weekly update",
      "num_slides": 5
    }
  }
}

Standard Presentation

{
  "method": "tools/call",
  "params": {
    "name": "generate_slides",
    "arguments": {
      "topic": "Product Launch",
      "instructions": "Create a comprehensive product launch presentation",
      "num_slides": 20
    }
  }
}

Comprehensive Presentation

{
  "method": "tools/call",
  "params": {
    "name": "generate_slides",
    "arguments": {
      "topic": "Advanced Machine Learning",
      "instructions": "Create a detailed educational presentation",
      "num_slides": 30
    }
  }
}

Document-Based Generation

When generating from documents, the system considers:

Document length
Content density
Number of sections
Your specified num_slides parameter

# Let system determine
curl -X POST "https://poe.poesius.com/api/v1/slides/generate-from-doc" \
  -H "X-API-Key: pk_your_api_key" \
  -F "document=@document.pdf"

# Specify target
curl -X POST "https://poe.poesius.com/api/v1/slides/generate-from-doc" \
  -H "X-API-Key: pk_your_api_key" \
  -F "document=@document.pdf" \
  -F "num_slides=15"

Tips

Start Conservative: Begin with fewer slides, you can always add more
Content Quality: More slides doesn’t always mean better - focus on quality
Audience Consideration: Consider your audience’s attention span
Time Constraints: Match slide count to available presentation time

Generate Slides

Learn about generating slides

Templates Overview

Learn about templates

​Specifying Slide Count

​REST API

​MCP

​Behavior

​Best Practices

​Short Presentations

​Standard Presentations

​Comprehensive Presentations

​Document-Based

​Examples

​Short Presentation

​Standard Presentation

​Comprehensive Presentation

​Document-Based Generation

​Tips