curl -X POST https://api.presenton.ai/api/v1/ppt/presentation/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-presenton-84b3a021fbbbbc6ef6c1bd37fe7b541a155b67fee08a311092809921f7670b4d53a804e73062b56b7253d0cddf35d89e6d3b7320efdcedbb1cac7617e94b2068" \                                      
  -d '{                                                                             "content": "Introduction to Machine Learning",
    "instructions": "Focus on beginner-friendly explanations and add examples.",                            
    "tone": "educational",
    "verbosity": "standard",
    "web_search": true,
    "image_type": "ai-generated",
    "n_slides": 5,
    "language": "English",
    "template": "general",
    "include_table_of_contents": true,
    "include_title_slide": true,
    "export_as": "pptx"
  }'

{
  "presentation_id": "d3000f96-096c-4768-b67b-e99aed029b57",
  "path": "https://api.presenton.ai/static/user_data/d3000f96-096c-4768-b67b-e99aed029b57/Introduction_to_Machine_Learning.pptx",
  "edit_path": "https://presenton.ai/presentation?id=d3000f96-096c-4768-b67b-e99aed029b57",
  "credits_consumed": 5
}
Beyond templates and themes, you can also influence how your presentation communicates.
These controls let you adjust the tone, verbosity, images, and other behavior of the generated slides so they better fit your audience and purpose.

​
🗣️ Tone

The tone parameter defines the “voice” of your presentation text — how it sounds to the reader.
This helps align the slides with your audience, whether they are executives, students, or a casual group. Available options:
  • default – Neutral and balanced style. Suitable for most general use cases.
  • casual – Relaxed, conversational tone. Great for informal talks or creative sessions.
  • professional – Polished, formal language. Best for business, corporate, or client-facing decks.
  • funny – Lighthearted and humorous. Good for entertainment or informal events.
  • educational – Clear, explanatory style. Useful for teaching, training, or academic contexts.
  • sales_pitch – Persuasive and benefit-driven tone. Ideal for product demos, pitches, or marketing.

​
📏 Verbosity

The verbosity parameter controls how much detail the generated text contains.
This allows you to fine-tune whether slides are short and visual, or more text-heavy and explanatory. Options:
  • concise – Minimal text with short points. Focus on visuals and quick delivery.
  • standard – Balanced detail (default). Combines clarity with brevity.
  • text-heavy – Full sentences and detailed explanations. Suitable for reports or self-reading slides.
Enabling web_search lets the system pull in fresh, real-time information while generating your presentation.
This is useful when covering current events, market trends, or any topic that changes rapidly.
  • Default: false (disabled)
  • When enabled: Adds slight generation time overhead but ensures content is up-to-date.

​
🖼️ Image Type

The image_type parameter determines what kind of images are included in your slides. Options:
  • stock – Uses high-quality stock photography. Professional and realistic look.
  • ai-generated – Dynamically creates AI images to match your content. More unique and customizable.

​
🔢 Number of Slides

Use n_slides to decide how many slides should be generated.
  • Default: 8
  • Range: Support between 1-50 slides. Set it as per your use case.

​
🌍 Language

The language parameter sets the output language of the presentation.
  • Default: English
  • Any supported language can be used (e.g., "language": "Spanish").
  • Useful for multilingual teams, international clients, or localized training materials.

​
📖 Table of Contents

The include_table_of_contents parameter lets you automatically insert a Table of Contents slide at the start of your presentation.
  • Default: false (disabled)
  • When enabled: Slides with the main sections of your presentation is generated.
  • Use case: Perfect for long or structured decks (training, research, or business reports) where you want to give the audience an overview upfront.

​
🏷️ Title Slide

The include_title_slide parameter controls whether a cover slide is added to your presentation.
  • Default: true (enabled)
  • When enabled: The first slide will display your presentation title, subtitle, and optionally branding.
  • When disabled: The deck will start directly with content slides.
  • Use case: Enable for polished, professional presentations. Disable if you are merging this deck into another presentation that already has a cover slide.

​
📦 Export Format

The export_as parameter defines the final output format of the generated presentation.
  • Default: pptx
  • Available options:
    • pptx – Editable PowerPoint file (best for further customization).
    • pdf – Non-editable file (best for sharing, printing, or publishing).
curl -X POST https://api.presenton.ai/api/v1/ppt/presentation/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-presenton-84b3a021fbbbbc6ef6c1bd37fe7b541a155b67fee08a311092809921f7670b4d53a804e73062b56b7253d0cddf35d89e6d3b7320efdcedbb1cac7617e94b2068" \                                      
  -d '{                                                                             "content": "Introduction to Machine Learning",
    "instructions": "Focus on beginner-friendly explanations and add examples.",                            
    "tone": "educational",
    "verbosity": "standard",
    "web_search": true,
    "image_type": "ai-generated",
    "n_slides": 5,
    "language": "English",
    "template": "general",
    "include_table_of_contents": true,
    "include_title_slide": true,
    "export_as": "pptx"
  }'

{
  "presentation_id": "d3000f96-096c-4768-b67b-e99aed029b57",
  "path": "https://api.presenton.ai/static/user_data/d3000f96-096c-4768-b67b-e99aed029b57/Introduction_to_Machine_Learning.pptx",
  "edit_path": "https://presenton.ai/presentation?id=d3000f96-096c-4768-b67b-e99aed029b57",
  "credits_consumed": 5
}