2slides Presentation Generation

Generate professional presentations using the 2slides AI API. Supports content-based generation, style matching from reference images, and document summarization.

Setup Requirements

Users must have a 2slides API key:

1. 1. Visit https://2slides.com/api to create an API key
2. Store the key in environment variable: INLINECODE0

CODEBLOCK0

Workflow Decision Tree

Choose the appropriate approach based on the user's request:

CODEBLOCK1

1. Content-Based Generation

Generate slides from user-provided text content.

When to Use

• - User provides content directly in their message
• User says "create a presentation about X"
• User provides structured outline or bullet points

Workflow

Step 1: Prepare Content

Structure the content clearly for best results:

CODEBLOCK2

Step 2: Choose Theme (Required)

Search for an appropriate theme (themeId is required):

CODEBLOCK3

Pick a theme ID from the results.

Step 3: Generate Slides

Use the generate_slides.py script with the theme ID:

CODEBLOCK4

Step 4: Handle Results

Sync mode response:
CODEBLOCK5

Provide both URLs to the user:

• - slideUrl: Interactive online slides
• INLINECODE3: Downloadable PDF version

Async mode response:
CODEBLOCK6

Poll for results:

python scripts/get_job_status.py --job-id "job123"

2. Reference Image Generation

Generate slides that match the style of a reference image.

When to Use

• - User provides an image URL and says "create slides like this"
• User wants to match existing brand/design style
• User has a template image they want to emulate

Workflow

Step 1: Verify Image URL

Ensure the reference image is:

• - Publicly accessible URL
• Valid image format (PNG, JPG, etc.)
• Represents the desired slide style

Step 2: Generate Slides

Use the generate_slides.py script with --reference-image:

CODEBLOCK8

Optional parameters:
CODEBLOCK9

Note: This uses Nano Banana Pro mode with credit costs:

• - 1K/2K: 100 credits per page
• 4K: 200 credits per page

Step 3: Handle Results

This mode always runs synchronously and returns:
CODEBLOCK10

Provide both URLs to the user:

• - slideUrl: View slides in 2slides workspace
• INLINECODE7: Direct PDF download (expires in 1 hour)

Processing time: ~30 seconds per page (30-60 seconds typical for 1-2 pages)

3. Document Summarization

Generate slides from document content.

When to Use

• - User uploads a document (PDF, DOCX, TXT, etc.)
• User says "create slides from this document"
• User wants to summarize long content into presentation format

Workflow

Step 1: Read Document

Use appropriate tool to read the document content:

• - PDF: Use PDF reading tools
• DOCX: Use DOCX reading tools
• TXT/MD: Use Read tool

Step 2: Extract Key Points

Analyze the document and extract:

• - Main topics and themes
• Key points for each section
• Important data, quotes, or examples
• Logical flow and structure

Step 3: Structure Content

Format extracted information into presentation structure:

CODEBLOCK11

Step 4: Generate Slides

Use content-based generation workflow (Section 1). First search for a theme, then generate:

CODEBLOCK12

Tips:

• - Keep slides concise (3-5 points per slide)
• Focus on key insights, not full text
• Use document headings as slide titles
• Include important statistics or quotes
• Ask user if they want specific sections highlighted

4. Theme Search

Find appropriate themes for presentations.

When to Use

• - Before generating slides with specific styling
• User asks "what themes are available?"
• User wants professional or branded appearance

Workflow

Search themes:

CODEBLOCK13

Theme selection:

1. 1. Show user available themes with names and descriptions
2. Ask user to choose or let them use default
3. Use the theme ID in generation request

Using the MCP Server

If the 2slides MCP server is configured in Claude Desktop, use the integrated tools instead of scripts.

Two Configuration Modes:

1. 1. Streamable HTTP Protocol (Recommended)

1. 2. NPM Package (stdio)

Available MCP tools:

• - slides_generate - Generate slides from content
• INLINECODE11 - Generate from reference image
• INLINECODE12 - Search themes
• INLINECODE13 - Check job status

See mcp-integration.md for complete setup instructions and detailed tool documentation.

When to use MCP vs scripts:

• - Use MCP in Claude Desktop when configured
• Use scripts in Claude Code CLI or when MCP not available

Advanced Features

Sync vs Async Mode

Sync Mode (default):

• - Waits for generation to complete (30-60 seconds)
• Returns results immediately
• Best for quick presentations

Async Mode:

• - Returns job ID immediately
• Poll for results with INLINECODE14
• Best for large presentations or batch processing

Language Support

Generate slides in multiple languages (use full language name):

CODEBLOCK14

And more: Arabic, Portuguese, Indonesian, Russian, Hindi, Vietnamese, Turkish, Polish, Italian

Error Handling

Common issues:

1. 1. Missing API key

1. 2. Rate limiting

1. 3. Invalid content

   Error: 400 Bad Request
   Solution: Verify content format and parameters
   

Complete API Reference

For detailed API documentation, see api-reference.md

Includes:

• - All endpoints and parameters
• Request/response formats
• Authentication details
• Rate limits and best practices
• Error codes and handling

Tips for Best Results

Content Structure:

• - Use clear headings and subheadings
• Keep bullet points concise
• Limit to 3-5 points per section
• Include relevant examples or data

Theme Selection:

• - Theme ID is required for standard generation
• Search with keywords matching presentation purpose
• Common searches: "business", "professional", "creative", "education", "modern"
• Each theme has unique styling and layout

Reference Images:

• - Use high-quality images for best results
• Can use URL or base64 encoded image
• Public URL must be accessible
• Consider resolution setting (1K/2K/4K) based on quality needs
• Use page=0 for automatic slide count detection

Document Processing:

• - Extract only key information
• Don't try to fit entire document in slides
• Focus on main insights and takeaways
• Ask user which sections to emphasize