> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poesius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slide Count

> Control the number of slides in your presentations

## Specifying Slide Count

You can control the number of slides in several ways:

### REST API

```bash theme={null}
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

```json theme={null}
{
  "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

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

### Standard Presentation

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

### Comprehensive Presentation

```json theme={null}
{
  "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

```bash theme={null}
# 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

<Card title="Generate Slides" icon="wand-magic" href="/api/generate-slides">
  Learn about generating slides
</Card>

<Card title="Templates Overview" icon="palette" href="/templates/overview">
  Learn about templates
</Card>