--- name: 2slides description: AI-powered presentation generation using 2slides API. Create slides from text content, match reference image styles, or summarize documents into presentations. Use when users request to "create a presentation", "make slides", "generate a deck", "create slides from this content/document/image", or any presentation creation task. Supports theme selection, multiple languages, and both synchronous and asynchronous generation modes. ---

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 and credits:

1. Get API Key: Visit https://2slides.com/api to create an account and API key

- New users receive 500 free credits (~50 Fast PPT pages)

1. Purchase Credits (Optional): Visit https://2slides.com/pricing to buy additional credits

- Pay-as-you-go, no subscriptions - Credits never expire - Up to 20% off on larger packages

1. Set API Key: Store the key in environment variable: SLIDES_2SLIDES_API_KEY

export SLIDES_2SLIDES_API_KEY="your_api_key_here"

Credit Costs:

• Fast PPT: 10 credits/page
• Nano Banana 1K/2K: 100 credits/page
• Nano Banana 4K: 200 credits/page
• Voice Narration: 210 credits/page
• Download Export: FREE

See references/pricing.md for detailed pricing information.

Workflow Decision Tree

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

User Request
│
├─ "Create slides from this content/text"
│  └─> Use Content-Based Generation (Section 1)
│
├─ "Create slides like this image"
│  └─> Use Reference Image Generation (Section 2)
│
├─ "Create custom designed slides" or "Create PDF slides"
│  └─> Use Custom PDF Generation (Section 3)
│
├─ "Create slides from this document"
│  └─> Use Document Summarization (Section 4)
│
├─ "Add voice narration" or "Generate audio for slides"
│  └─> Use Voice Narration (Section 5)
│
├─ "Download slides as images" or "Export slides and voices"
│  └─> Use Download Export (Section 6)
│
└─ "Search for themes" or "What themes are available?"
   └─> Use Theme Search (Section 7)

---

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:

Title: [Main Topic]

Section 1: [Subtopic]
- Key point 1
- Key point 2
- Key point 3

Section 2: [Subtopic]
- Key point 1
- Key point 2

Step 2: Choose Theme (Required)

Search for an appropriate theme (themeId is required):

python scripts/search_themes.py --query "business"
python scripts/search_themes.py --query "professional"
python scripts/search_themes.py --query "creative"

Pick a theme ID from the results.

Step 3: Generate Slides

Use the generate_slides.py script with the theme ID:

# Basic generation (theme ID required)
python scripts/generate_slides.py --content "Your content here" --theme-id "theme123"

# In different language
python scripts/generate_slides.py --content "Your content" --theme-id "theme123" --language "Spanish"

# Async mode for longer presentations
python scripts/generate_slides.py --content "Your content" --theme-id "theme123" --mode async

Step 4: Handle Results

Sync mode response:

{
  "slideUrl": "https://2slides.com/slides/abc123",
  "pdfUrl": "https://2slides.com/slides/abc123/download",
  "status": "completed"
}

Provide both URLs to the user:

• slideUrl: Interactive online slides
• pdfUrl: Downloadable PDF version

Async mode response:

{
  "jobId": "job123",
  "status": "pending"
}

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:

python scripts/generate_slides.py \
  --content "Your presentation content" \
  --reference-image "https://example.com/template.jpg" \
  --language "Auto"

Optional parameters:

--aspect-ratio "16:9"           # width:height format (e.g., "16:9", "4:3")
--resolution "2K"               # "1K", "2K" (default), or "4K"
--page 5                        # Number of slides (0 for auto-detection, max 100)
--content-detail "concise"      # "concise" (brief) or "standard" (detailed)

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:

{
  "slideUrl": "https://2slides.com/workspace?jobId=...",
  "pdfUrl": "https://...pdf...",
  "status": "completed",
  "message": "Successfully generated N slides",
  "slidePageCount": N
}

Provide both URLs to the user:

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

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

---

3. Custom PDF Generation

Generate custom-designed slides from text without needing a reference image.

When to Use

• User wants custom design without providing a reference image
• User requests "create PDF slides"
• User wants to specify design characteristics
• Alternative to theme-based generation with more design flexibility

Workflow

Step 1: Prepare Content

Structure the content clearly:

Title: [Main Topic]

Section 1: [Subtopic]
- Key point 1
- Key point 2

Section 2: [Subtopic]
- Key point 1
- Key point 2

Step 2: Generate Slides

Use the create_pdf_slides.py script:

# Basic generation
python scripts/create_pdf_slides.py --content "Your content here"

# With design specifications
python scripts/create_pdf_slides.py \
  --content "Sales Report Q4 2025" \
  --design-spec "modern minimalist, blue color scheme"

# High resolution with auto page detection
python scripts/create_pdf_slides.py \
  --content "Marketing Plan" \
  --resolution "4K" \
  --page 0 \
  --content-detail "standard"

Optional parameters:

--design-spec "text"            # Design specifications (e.g., "corporate professional")
--aspect-ratio "16:9"           # width:height format
--resolution "2K"               # "1K", "2K" (default), or "4K"
--page 5                        # Number of slides (0 for auto-detection, max 100)
--content-detail "concise"      # "concise" (brief) or "standard" (detailed)
--language "Auto"               # Language for content

Step 3: Handle Results

Returns same structure as create-like-this:

{
  "slideUrl": "https://2slides.com/workspace?jobId=...",
  "pdfUrl": "https://...pdf...",
  "status": "completed",
  "message": "Successfully generated N slides",
  "slidePageCount": N
}

Notes:

• Same credit costs as create-like-this (100 credits/page for 1K/2K, 200 for 4K)
• Processing time: ~30 seconds per page
• Automatically generates PDF
• Uses AI to create custom design based on content and specs

---

4. 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

...