📦 deps(thirdparty): update snapshots
This commit is contained in:
ci[bot]
@@ -0,0 +1,499 @@
|
||||
# 2slides API Reference
|
||||
|
||||
Complete API documentation for 2slides slide generation service.
|
||||
|
||||
## Base URL
|
||||
|
||||
```
|
||||
https://2slides.com/api/v1
|
||||
```
|
||||
|
||||
## Authentication
|
||||
|
||||
All API requests require authentication using a Bearer token in the Authorization header:
|
||||
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
```
|
||||
|
||||
Get your API key from: https://2slides.com/api
|
||||
|
||||
Store the API key in environment variable: `SLIDES_2SLIDES_API_KEY`
|
||||
|
||||
## Endpoints
|
||||
|
||||
### 1. Generate Slides
|
||||
|
||||
Generate slides from user input with optional theme selection.
|
||||
|
||||
**Endpoint:** `POST /slides/generate`
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
**Request Body:**
|
||||
```json
|
||||
{
|
||||
"userInput": "string (required) - Content to convert into slides",
|
||||
"themeId": "string (required) - Theme ID from themes/search",
|
||||
"responseLanguage": "string (optional, default: 'Auto') - Language code",
|
||||
"mode": "string (optional, default: 'sync') - 'sync' or 'async'"
|
||||
}
|
||||
```
|
||||
|
||||
**Supported Languages:**
|
||||
Auto, English, Simplified Chinese (简体中文), Traditional Chinese (繁體中文), Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Vietnamese, Turkish, Polish, Italian, Korean
|
||||
|
||||
**Response (sync mode):**
|
||||
```json
|
||||
{
|
||||
"slideUrl": "https://2slides.com/slides/...",
|
||||
"pdfUrl": "https://2slides.com/slides/.../download",
|
||||
"status": "completed"
|
||||
}
|
||||
```
|
||||
|
||||
**Response (async mode):**
|
||||
```json
|
||||
{
|
||||
"jobId": "abc123...",
|
||||
"status": "pending"
|
||||
}
|
||||
```
|
||||
|
||||
**Notes:**
|
||||
- **Sync mode**: Waits for generation to complete and returns the result directly (may take 30-60 seconds)
|
||||
- **Async mode**: Returns immediately with a jobId to poll for results using `/jobs/{jobId}`
|
||||
|
||||
---
|
||||
|
||||
### 2. Create Like This (Reference Image)
|
||||
|
||||
Generate slides matching a reference image style (Nano Banana Pro mode).
|
||||
|
||||
**Endpoint:** `POST /slides/create-like-this`
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
**Request Body:**
|
||||
```json
|
||||
{
|
||||
"userInput": "string (required) - Content for slides",
|
||||
"referenceImageUrl": "string (required) - URL or base64 of reference image",
|
||||
"responseLanguage": "string (optional, default: 'Auto')",
|
||||
"aspectRatio": "string (optional, default: '16:9') - width:height format",
|
||||
"resolution": "string (optional, default: '2K') - '1K', '2K', or '4K'",
|
||||
"page": "number (optional, default: 1) - 0 for auto-detection, max 100",
|
||||
"contentDetail": "string (optional, default: 'concise') - 'concise' or 'standard'"
|
||||
}
|
||||
```
|
||||
|
||||
**Resolution Options:**
|
||||
- **1K**: Standard quality
|
||||
- **2K**: High quality (default)
|
||||
- **4K**: Ultra high quality
|
||||
|
||||
**Content Detail Options:**
|
||||
- **concise**: Brief, keyword-focused content
|
||||
- **standard**: Comprehensive, detailed content
|
||||
|
||||
**Page Parameter:**
|
||||
- Set to `0` to enable automatic slide count detection
|
||||
- Set to specific number (1-100) for exact slide count
|
||||
|
||||
**Response:**
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"jobId": "608f8997-5207-480c-9ff2-d2475cba6b9d",
|
||||
"status": "success",
|
||||
"message": "Successfully generated N slides",
|
||||
"downloadUrl": "https://...pdf...",
|
||||
"jobUrl": "https://2slides.com/workspace?jobId=...",
|
||||
"createdAt": 1770108913384,
|
||||
"updatedAt": 1770108934015,
|
||||
"slidePageCount": 3,
|
||||
"successCount": 3,
|
||||
"failedCount": 0
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Response Fields:**
|
||||
- `success`: Boolean indicating if request succeeded
|
||||
- `data.jobId`: Unique job identifier
|
||||
- `data.status`: Generation status ("success" or "failed")
|
||||
- `data.message`: Human-readable status message
|
||||
- `data.downloadUrl`: Direct PDF download URL (temporary, expires in 1 hour)
|
||||
- `data.jobUrl`: View slides in 2slides workspace
|
||||
- `data.slidePageCount`: Number of slides generated
|
||||
- `data.successCount`: Number of successfully generated slides
|
||||
- `data.failedCount`: Number of failed slides
|
||||
|
||||
**Notes:**
|
||||
- This endpoint always runs synchronously
|
||||
- Processing time: ~30 seconds per page
|
||||
- Typical response time: 30-60 seconds for 1-2 pages
|
||||
- Automatically generates PDF
|
||||
- Matches the style and design of the reference image
|
||||
- **Timeout recommendation**: Set timeout to `max(120, pages * 40)` seconds
|
||||
|
||||
---
|
||||
|
||||
### 3. Create PDF Slides
|
||||
|
||||
Generate custom-designed slides from text with optional design specifications.
|
||||
|
||||
**Endpoint:** `POST /slides/create-pdf-slides`
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
**Request Body:**
|
||||
```json
|
||||
{
|
||||
"userInput": "string (required) - Content for slides",
|
||||
"responseLanguage": "string (optional, default: 'Auto')",
|
||||
"aspectRatio": "string (optional, default: '16:9') - width:height format",
|
||||
"resolution": "string (optional, default: '2K') - '1K', '2K', or '4K'",
|
||||
"page": "number (optional, default: 1) - 0 for auto-detection, max 100",
|
||||
"contentDetail": "string (optional, default: 'concise') - 'concise' or 'standard'",
|
||||
"designSpec": "string (optional) - Design specifications (e.g., 'modern minimalist')"
|
||||
}
|
||||
```
|
||||
|
||||
**Response:**
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"jobId": "608f8997-5207-480c-9ff2-d2475cba6b9d",
|
||||
"status": "success",
|
||||
"message": "Successfully generated N slides",
|
||||
"downloadUrl": "https://...pdf...",
|
||||
"jobUrl": "https://2slides.com/workspace?jobId=...",
|
||||
"slidePageCount": 3,
|
||||
"successCount": 3,
|
||||
"failedCount": 0
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Notes:**
|
||||
- Similar to create-like-this but without reference image
|
||||
- Uses AI to generate custom design based on content and design specs
|
||||
- Same credit costs: 100 credits/page (1K/2K), 200 credits/page (4K)
|
||||
- Processing time: ~30 seconds per page
|
||||
- Always runs synchronously
|
||||
|
||||
---
|
||||
|
||||
### 4. Generate Narration
|
||||
|
||||
Add AI voice narration to slides in single or multi-speaker mode.
|
||||
|
||||
**Endpoint:** `POST /slides/generate-narration`
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
**Request Body:**
|
||||
```json
|
||||
{
|
||||
"jobId": "string (required) - Job ID from slide generation (UUID format)",
|
||||
"language": "string (optional, default: 'Auto') - Language for narration",
|
||||
"voice": "string (optional, default: 'Puck') - Voice name from available voices",
|
||||
"multiSpeaker": "boolean (optional, default: false) - Enable multi-speaker mode"
|
||||
}
|
||||
```
|
||||
|
||||
**Available Voices (30 total):**
|
||||
Puck, Aoede, Charon, Kore, Fenrir, Phoebe, Asteria, Luna, Stella, Theia, Helios, Atlas, Clio, Melpomene, Calliope, Erato, Euterpe, Polyhymnia, Terpsichore, Thalia, Urania, Zeus, Hera, Poseidon, Athena, Apollo, Artemis, Ares, Aphrodite, Hephaestus
|
||||
|
||||
**Response:**
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"jobId": "abc123...",
|
||||
"status": "pending",
|
||||
"message": "Narration generation started"
|
||||
}
|
||||
```
|
||||
|
||||
**Notes:**
|
||||
- Job must be completed before adding narration
|
||||
- Job ID must be UUID format for Nano Banana jobs
|
||||
- Cost: 210 credits per page (10 for text, 200 for audio)
|
||||
- Runs asynchronously - poll with /jobs/{jobId}
|
||||
- Multi-speaker mode uses different voices for variety
|
||||
- 19 languages supported plus auto-detection
|
||||
|
||||
---
|
||||
|
||||
### 5. Download Slides Pages and Voices
|
||||
|
||||
Export slides as PNG files and voice narrations as WAV files in a ZIP archive.
|
||||
|
||||
**Endpoint:** `POST /slides/download-slides-pages-voices`
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
**Request Body:**
|
||||
```json
|
||||
{
|
||||
"jobId": "string (required) - Job ID from slide generation"
|
||||
}
|
||||
```
|
||||
|
||||
**Response:**
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"downloadUrl": "https://...zip...",
|
||||
"message": "Download ready"
|
||||
}
|
||||
```
|
||||
|
||||
**Archive Contents:**
|
||||
- Pages: PNG files for each slide
|
||||
- Voices: WAV audio files (if narration generated)
|
||||
- Transcripts: Text files with narration transcripts
|
||||
|
||||
**Notes:**
|
||||
- **Cost: Completely FREE** (no credits used)
|
||||
- Download URL valid for **1 hour only**
|
||||
- High quality PNG export
|
||||
- WAV format for audio
|
||||
- Includes all slides and voice files
|
||||
|
||||
---
|
||||
|
||||
### 6. Search Themes
|
||||
|
||||
Search for available presentation themes.
|
||||
|
||||
**Endpoint:** `GET /themes/search`
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
```
|
||||
|
||||
**Query Parameters:**
|
||||
```
|
||||
query: string (required) - Search keyword
|
||||
limit: number (optional, default: 20, max: 100)
|
||||
```
|
||||
|
||||
**Response:**
|
||||
```json
|
||||
{
|
||||
"themes": [
|
||||
{
|
||||
"id": "theme_id_123",
|
||||
"name": "Professional Blue",
|
||||
"description": "Clean professional theme with blue accents",
|
||||
"previewUrl": "https://..."
|
||||
}
|
||||
],
|
||||
"count": 1
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. Get Job Status
|
||||
|
||||
Retrieve the status and results of an async generation job.
|
||||
|
||||
**Endpoint:** `GET /jobs/{jobId}`
|
||||
|
||||
**Headers:**
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
```
|
||||
|
||||
**Path Parameters:**
|
||||
```
|
||||
jobId: string (required) - Job ID from async generation
|
||||
```
|
||||
|
||||
**Response:**
|
||||
```json
|
||||
{
|
||||
"jobId": "abc123",
|
||||
"status": "completed|pending|failed",
|
||||
"slideUrl": "https://2slides.com/slides/...",
|
||||
"pdfUrl": "https://2slides.com/slides/.../download",
|
||||
"narrationStatus": "completed|pending|not_started",
|
||||
"error": "error message if failed"
|
||||
}
|
||||
```
|
||||
|
||||
**Status Values:**
|
||||
- `pending`: Job is still processing
|
||||
- `completed`: Slides are ready
|
||||
- `failed`: Generation failed (see error field)
|
||||
|
||||
**Narration Status Values:**
|
||||
- `not_started`: No narration requested
|
||||
- `pending`: Narration is being generated
|
||||
- `completed`: Narration is ready
|
||||
|
||||
**Polling Recommendation:**
|
||||
Poll every 20-30 seconds to avoid server strain
|
||||
|
||||
---
|
||||
|
||||
## Error Handling
|
||||
|
||||
All endpoints return standard HTTP status codes:
|
||||
|
||||
- `200 OK`: Request succeeded
|
||||
- `400 Bad Request`: Invalid parameters
|
||||
- `401 Unauthorized`: Missing or invalid API key
|
||||
- `404 Not Found`: Resource not found
|
||||
- `429 Too Many Requests`: Rate limit exceeded
|
||||
- `500 Internal Server Error`: Server error
|
||||
|
||||
**Error Response Format:**
|
||||
```json
|
||||
{
|
||||
"error": "Error message",
|
||||
"code": "ERROR_CODE"
|
||||
}
|
||||
```
|
||||
|
||||
**Common Error Codes:**
|
||||
- `INSUFFICIENT_CREDITS`: Account has insufficient credits
|
||||
- `INVALID_JOB_ID`: Job ID not found or invalid format
|
||||
- `RATE_LIMIT_EXCEEDED`: Too many requests (see rate limits below)
|
||||
- `JOB_NOT_COMPLETED`: Job must complete before adding narration
|
||||
- `INVALID_UUID`: Job ID must be UUID format (for Nano Banana jobs)
|
||||
|
||||
---
|
||||
|
||||
## Credit Costs
|
||||
|
||||
- **Fast PPT (generate endpoint)**: 10 credits per page
|
||||
- **Nano Banana 1K/2K (create-like-this, create-pdf-slides)**: 100 credits per page
|
||||
- **Nano Banana 4K**: 200 credits per page
|
||||
- **Voice Narration**: 210 credits per page (10 for text, 200 for audio)
|
||||
- **Download Export**: FREE (no credits)
|
||||
|
||||
## Purchasing Credits
|
||||
|
||||
2slides operates on a **pay-as-you-go credit system** with no subscriptions.
|
||||
|
||||
**Credit Packages** (Current promotion: up to 20% off):
|
||||
|
||||
| Credits | Price | Cost per 1,000 | Savings |
|
||||
|---------|-------|---------------|---------|
|
||||
| 2,000 | $5.00 | $2.50 | — |
|
||||
| 4,000 | $9.50 | $2.38 | 5% |
|
||||
| 10,000 | $22.50 | $2.25 | 10% |
|
||||
| 20,000 | $42.50 | $2.13 | 15% |
|
||||
| 40,000 | $80.00 | $2.00 | 20% |
|
||||
|
||||
**Key Benefits:**
|
||||
- New users get **500 free credits** (~50 Fast PPT pages)
|
||||
- **Credits never expire**
|
||||
- No monthly subscriptions
|
||||
- 3-day refund window
|
||||
- Purchase at: https://2slides.com/pricing
|
||||
|
||||
**Example Costs:**
|
||||
- 10-slide Fast PPT presentation: 100 credits ($0.25 with largest package)
|
||||
- 10-slide Nano Banana 2K presentation: 1,000 credits ($2.00 with largest package)
|
||||
- 10-slide presentation with narration: 2,100 credits ($4.20 with largest package)
|
||||
|
||||
## Rate Limits
|
||||
|
||||
Different endpoints have different rate limits:
|
||||
|
||||
- **Fast PPT (generate)**: 10 requests per minute
|
||||
- **Nano Banana (create-like-this, create-pdf-slides)**: 6 requests per minute
|
||||
|
||||
**Best Practices:**
|
||||
- Poll async jobs every 20-30 seconds to avoid server strain
|
||||
- If rate limited (429 error), wait before retrying
|
||||
- Check your plan's rate limits at https://2slides.com/api
|
||||
|
||||
## Download URL Expiration
|
||||
|
||||
All download URLs (PDF, ZIP archives) remain valid for **1 hour only**. Download files promptly after generation.
|
||||
|
||||
---
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Content Formatting
|
||||
|
||||
**For best results, structure content clearly:**
|
||||
|
||||
```
|
||||
Title: Introduction to AI
|
||||
|
||||
Section 1: Machine Learning
|
||||
- Definition
|
||||
- Key concepts
|
||||
- Applications
|
||||
|
||||
Section 2: Deep Learning
|
||||
- Neural networks
|
||||
- Training process
|
||||
- Use cases
|
||||
```
|
||||
|
||||
### Choosing Sync vs Async Mode
|
||||
|
||||
- **Use sync** for quick generations (<5 slides)
|
||||
- **Use async** for larger presentations (>5 slides)
|
||||
- **Use async** when integrating into workflows that can poll
|
||||
|
||||
### Theme Selection
|
||||
|
||||
1. Search themes with relevant keywords
|
||||
2. Preview themes if URLs available
|
||||
3. Use theme ID in generation request
|
||||
4. Leave theme blank for default styling
|
||||
|
||||
### Language Support
|
||||
|
||||
Specify `responseLanguage` to generate slides in different languages:
|
||||
- `"Auto"` - Automatic language detection (default)
|
||||
- `"English"` - English
|
||||
- `"Simplified Chinese"` - 简体中文
|
||||
- `"Traditional Chinese"` - 繁體中文
|
||||
- `"Spanish"` - Español
|
||||
- `"Arabic"` - العربية
|
||||
- `"Portuguese"` - Português
|
||||
- `"Indonesian"` - Bahasa Indonesia
|
||||
- `"Japanese"` - 日本語
|
||||
- `"Russian"` - Русский
|
||||
- `"Hindi"` - हिन्दी
|
||||
- `"French"` - Français
|
||||
- `"German"` - Deutsch
|
||||
- `"Vietnamese"` - Tiếng Việt
|
||||
- `"Turkish"` - Türkçe
|
||||
- `"Polish"` - Polski
|
||||
- `"Italian"` - Italiano
|
||||
- `"Korean"` - 한국어
|
||||
+282
@@ -0,0 +1,282 @@
|
||||
# MCP Integration Guide
|
||||
|
||||
2slides provides an MCP (Model Context Protocol) server for seamless integration with Claude Desktop and other MCP-compatible AI agents.
|
||||
|
||||
## What is the MCP Server?
|
||||
|
||||
The 2slides MCP server exposes the same API functionality as direct API calls, but through a standardized tool interface that Claude can use directly without requiring script execution.
|
||||
|
||||
**Available Tools:**
|
||||
1. `slides_generate` - Generate slides from content
|
||||
2. `slides_create_like_this` - Generate slides from reference image
|
||||
3. `slides_create_pdf_slides` - Generate custom-designed slides (NEW)
|
||||
4. `slides_generate_narration` - Add AI voice narration (NEW)
|
||||
5. `slides_download_pages_voices` - Export slides and voices as ZIP (NEW)
|
||||
6. `themes_search` - Search available themes
|
||||
7. `jobs_get` - Check job status
|
||||
|
||||
**Note:** New tools (3-5) may require MCP server update to latest version.
|
||||
|
||||
## Installation & Configuration
|
||||
|
||||
2slides MCP server supports two integration modes:
|
||||
|
||||
### Mode 1: Streamable HTTP Protocol (Recommended)
|
||||
|
||||
Simplest setup using HTTP endpoint. No local installation required.
|
||||
|
||||
**Step 1:** Get your API key from https://2slides.com/api
|
||||
|
||||
**Step 2:** Configure Claude Desktop
|
||||
|
||||
Edit: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"2slides": {
|
||||
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Step 3:** Restart Claude Desktop completely
|
||||
|
||||
**Advantages:**
|
||||
- ✅ No Node.js or npm required
|
||||
- ✅ Always uses latest version
|
||||
- ✅ Faster setup
|
||||
- ✅ No local dependencies
|
||||
|
||||
---
|
||||
|
||||
### Mode 2: NPM Package (stdio)
|
||||
|
||||
Uses local npm package for MCP server.
|
||||
|
||||
**Step 1:** Get your API key from https://2slides.com/api
|
||||
|
||||
**Step 2:** Configure Claude Desktop
|
||||
|
||||
Edit: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"2slides": {
|
||||
"command": "npx",
|
||||
"args": ["2slides-mcp"],
|
||||
"env": {
|
||||
"API_KEY": "YOUR_2SLIDES_API_KEY"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Step 3:** Restart Claude Desktop completely
|
||||
|
||||
**Requirements:**
|
||||
- Node.js and npm installed
|
||||
- Internet connection for first-time package download
|
||||
|
||||
---
|
||||
|
||||
### Verify Installation
|
||||
|
||||
After restart, the 2slides tools should be available. Test by asking:
|
||||
"Search for business themes using 2slides"
|
||||
|
||||
## When to Use MCP vs Direct API
|
||||
|
||||
### Use MCP Server When:
|
||||
- Working in Claude Desktop or other MCP-compatible environments
|
||||
- Want seamless tool integration without script management
|
||||
- Prefer Claude to handle API calls directly
|
||||
- Need real-time interaction and feedback
|
||||
|
||||
### Use Direct API Scripts When:
|
||||
- Working in Claude Code CLI
|
||||
- MCP server is not configured or available
|
||||
- Need more control over parameters and error handling
|
||||
- Integrating into custom workflows or automation
|
||||
- Need to batch process multiple requests
|
||||
|
||||
## MCP Tool Details
|
||||
|
||||
### slides_generate
|
||||
|
||||
Generate slides from user content.
|
||||
|
||||
**Parameters:**
|
||||
- `userInput` (string, required): Content to convert
|
||||
- `themeId` (string, required): Theme ID from themes_search
|
||||
- `responseLanguage` (string, optional, default: "Auto"): Language name
|
||||
- `mode` (string, optional, default: "sync"): "sync" or "async"
|
||||
|
||||
**Example:**
|
||||
```
|
||||
First search for a theme:
|
||||
Use themes_search with:
|
||||
- query: "business"
|
||||
|
||||
Then generate with the theme ID:
|
||||
Use slides_generate with:
|
||||
- userInput: "Introduction to Python: Variables, Functions, Classes"
|
||||
- themeId: "theme_abc123"
|
||||
- mode: "sync"
|
||||
```
|
||||
|
||||
### slides_create_like_this
|
||||
|
||||
Generate slides matching a reference image.
|
||||
|
||||
**Parameters:**
|
||||
- `userInput` (string, required): Content for slides
|
||||
- `referenceImageUrl` (string, required): URL or base64 of reference image
|
||||
- `responseLanguage` (string, optional, default: "Auto"): Language name
|
||||
- `aspectRatio` (string, optional, default: "16:9"): width:height format
|
||||
- `resolution` (string, optional, default: "2K"): "1K", "2K", or "4K"
|
||||
- `page` (number, optional, default: 1): Number of slides (0 for auto-detection, max 100)
|
||||
- `contentDetail` (string, optional, default: "concise"): "concise" or "standard"
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Use slides_create_like_this with:
|
||||
- userInput: "Sales Report Q4 2025"
|
||||
- referenceImageUrl: "https://example.com/template.jpg"
|
||||
- resolution: "2K"
|
||||
- page: 0 # Auto-detect slide count
|
||||
- contentDetail: "standard"
|
||||
```
|
||||
|
||||
### themes_search
|
||||
|
||||
Search for available themes.
|
||||
|
||||
**Parameters:**
|
||||
- `query` (string, required): Search keyword
|
||||
- `limit` (number, optional, default: 20, max: 100): Max results
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Use themes_search with:
|
||||
- query: "business"
|
||||
- limit: 10
|
||||
```
|
||||
|
||||
**Note:** Query parameter is required. Search with keywords like "business", "professional", "creative", "education", "modern" to find appropriate themes.
|
||||
|
||||
### slides_create_pdf_slides
|
||||
|
||||
Generate custom-designed slides from text without a reference image.
|
||||
|
||||
**Parameters:**
|
||||
- `userInput` (string, required): Content for slides
|
||||
- `responseLanguage` (string, optional, default: "Auto"): Language name
|
||||
- `aspectRatio` (string, optional, default: "16:9"): width:height format
|
||||
- `resolution` (string, optional, default: "2K"): "1K", "2K", or "4K"
|
||||
- `page` (number, optional, default: 1): Number of slides (0 for auto-detection, max 100)
|
||||
- `contentDetail` (string, optional, default: "concise"): "concise" or "standard"
|
||||
- `designSpec` (string, optional): Design specifications
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Use slides_create_pdf_slides with:
|
||||
- userInput: "Sales Report Q4 2025"
|
||||
- designSpec: "modern minimalist, blue color scheme"
|
||||
- resolution: "2K"
|
||||
- page: 0 # Auto-detect slide count
|
||||
```
|
||||
|
||||
### slides_generate_narration
|
||||
|
||||
Add AI voice narration to completed slides.
|
||||
|
||||
**Parameters:**
|
||||
- `jobId` (string, required): Job ID from slide generation (UUID format)
|
||||
- `language` (string, optional, default: "Auto"): Language for narration
|
||||
- `voice` (string, optional, default: "Puck"): Voice name (30 options available)
|
||||
- `multiSpeaker` (boolean, optional, default: false): Enable multi-speaker mode
|
||||
|
||||
**Available Voices:**
|
||||
Puck, Aoede, Charon, Kore, Fenrir, Phoebe, Asteria, Luna, Stella, Theia, Helios, Atlas, Clio, Melpomene, Calliope, Erato, Euterpe, Polyhymnia, Terpsichore, Thalia, Urania, Zeus, Hera, Poseidon, Athena, Apollo, Artemis, Ares, Aphrodite, Hephaestus
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Use slides_generate_narration with:
|
||||
- jobId: "abc-123-def-456"
|
||||
- voice: "Aoede"
|
||||
- multiSpeaker: true
|
||||
- language: "English"
|
||||
```
|
||||
|
||||
**Note:** Job must be completed before adding narration. Cost: 210 credits per page.
|
||||
|
||||
### slides_download_pages_voices
|
||||
|
||||
Download slides as PNG images and voice files as WAV in a ZIP archive.
|
||||
|
||||
**Parameters:**
|
||||
- `jobId` (string, required): Job ID from slide generation
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Use slides_download_pages_voices with:
|
||||
- jobId: "abc-123-def-456"
|
||||
```
|
||||
|
||||
**Note:** Completely FREE (no credits). Download URL valid for 1 hour.
|
||||
|
||||
### jobs_get
|
||||
|
||||
Check status of async job.
|
||||
|
||||
**Parameters:**
|
||||
- `jobId` (string, required): Job ID from async generation
|
||||
|
||||
**Response includes:**
|
||||
- Slide generation status
|
||||
- Narration status (if applicable)
|
||||
- Download URLs (when completed)
|
||||
|
||||
**Example:**
|
||||
```
|
||||
Use jobs_get with:
|
||||
- jobId: "abc123..."
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Tools Not Appearing
|
||||
|
||||
1. Verify configuration file syntax is valid JSON
|
||||
2. For HTTP mode: Check API key is correctly in the URL
|
||||
3. For npm mode: Ensure API key is correctly set in the `env` section
|
||||
4. Restart Claude Desktop completely (quit fully, not just close window)
|
||||
5. Check for error messages in Claude Desktop console
|
||||
|
||||
### API Key Issues
|
||||
|
||||
- Verify API key is active at https://2slides.com/api
|
||||
- Check for typos in the configuration
|
||||
- Ensure no extra quotes or spaces around the key
|
||||
- For HTTP mode: API key must be in the URL query parameter
|
||||
|
||||
### HTTP Mode Issues
|
||||
|
||||
- Verify URL format: `https://2slides.com/api/mcp?apikey=YOUR_KEY`
|
||||
- Check internet connectivity
|
||||
- Ensure API key has no special characters that need URL encoding
|
||||
|
||||
### NPM Mode Issues
|
||||
|
||||
- Ensure `npx` is available (requires Node.js)
|
||||
- Try running `npx 2slides-mcp` manually to check for errors
|
||||
- Verify internet connection for package download
|
||||
- Check Node.js version compatibility
|
||||
|
||||
## GitHub Repository
|
||||
|
||||
For more information, visit: https://github.com/2slides/mcp-2slides
|
||||
@@ -0,0 +1,195 @@
|
||||
# 2slides Pricing & Credit Information
|
||||
|
||||
Complete pricing details and credit system information.
|
||||
|
||||
## Credit System Overview
|
||||
|
||||
2slides operates on a **pay-as-you-go credit system** with no monthly subscriptions or recurring charges.
|
||||
|
||||
### Key Benefits
|
||||
|
||||
- ✅ **Credits never expire** - Use them at your own pace
|
||||
- ✅ **No subscriptions** - Pay only for what you use
|
||||
- ✅ **Volume discounts** - Save up to 20% on larger packages
|
||||
- ✅ **3-day refund window** - Risk-free purchase
|
||||
- ✅ **500 free credits** - Free trial for new users
|
||||
|
||||
## Credit Packages
|
||||
|
||||
**Current Promotion:** Up to 20% off credits for a limited time.
|
||||
|
||||
| Credits | Original Price | Current Price | Discount | Cost per 1,000 |
|
||||
|---------|----------------|---------------|----------|----------------|
|
||||
| 2,000 | $5.00 | $5.00 | — | $2.50 |
|
||||
| 4,000 | $10.00 | $9.50 | 5% | $2.38 |
|
||||
| 10,000 | $25.00 | $22.50 | 10% | $2.25 |
|
||||
| 20,000 | $50.00 | $42.50 | 15% | $2.13 |
|
||||
| 40,000 | $100.00 | $80.00 | 20% | $2.00 |
|
||||
|
||||
**Purchase at:** https://2slides.com/pricing
|
||||
|
||||
## Credit Costs by Feature
|
||||
|
||||
| Feature | Credits per Page | Example (10 pages) |
|
||||
|---------|-----------------|-------------------|
|
||||
| Fast PPT (theme-based) | 10 | 100 credits |
|
||||
| Nano Banana 1K/2K (image/custom) | 100 | 1,000 credits |
|
||||
| Nano Banana 4K | 200 | 2,000 credits |
|
||||
| Voice Narration | +210 | +2,100 credits |
|
||||
| Download Export | FREE | 0 credits |
|
||||
|
||||
### Detailed Cost Breakdown
|
||||
|
||||
**Fast PPT Generation (Theme-Based)**
|
||||
- 10 credits per page
|
||||
- Uses pre-designed themes
|
||||
- Fastest generation mode
|
||||
- Cost example: 20-page presentation = 200 credits
|
||||
|
||||
**Nano Banana (Image Matching / Custom PDF)**
|
||||
- **1K/2K resolution:** 100 credits per page
|
||||
- **4K resolution:** 200 credits per page
|
||||
- Matches reference image style or generates custom design
|
||||
- Higher quality output
|
||||
- Cost example: 10-page 2K presentation = 1,000 credits
|
||||
|
||||
**Voice Narration**
|
||||
- 210 credits per page total
|
||||
- 10 credits for text processing
|
||||
- 200 credits for audio generation
|
||||
- 30 voice options available
|
||||
- Multi-speaker mode included
|
||||
- Cost example: 5-page narration = 1,050 credits
|
||||
|
||||
**Download Export**
|
||||
- Completely FREE (0 credits)
|
||||
- Export slides as PNG images
|
||||
- Export voice files as WAV
|
||||
- Includes transcripts
|
||||
|
||||
## Free Trial
|
||||
|
||||
**New users receive 500 free credits** upon account creation.
|
||||
|
||||
**What you can do with 500 credits:**
|
||||
- Create ~50 Fast PPT slide pages
|
||||
- Create ~5 Nano Banana 2K pages
|
||||
- Create ~2 Nano Banana 2K pages with full narration
|
||||
- Mix and match features as needed
|
||||
|
||||
## Example Cost Calculations
|
||||
|
||||
### Scenario 1: Quick Business Presentation
|
||||
- **Need:** 15-slide Fast PPT presentation
|
||||
- **Credits required:** 150 credits (15 pages × 10 credits)
|
||||
- **Cost with 2,000 package:** $0.38
|
||||
- **Cost with 40,000 package:** $0.30
|
||||
|
||||
### Scenario 2: Branded Marketing Deck
|
||||
- **Need:** 20-slide Nano Banana 2K matching brand image
|
||||
- **Credits required:** 2,000 credits (20 pages × 100 credits)
|
||||
- **Cost with 4,000 package:** $4.75
|
||||
- **Cost with 40,000 package:** $4.00
|
||||
|
||||
### Scenario 3: Training Presentation with Audio
|
||||
- **Need:** 30-slide 2K presentation with voice narration
|
||||
- **Credits required:** 6,300 credits
|
||||
- Slides: 3,000 credits (30 pages × 100 credits)
|
||||
- Narration: 3,300 credits (30 pages × 110 credits - voice only)
|
||||
- **Cost with 10,000 package:** $14.18
|
||||
- **Cost with 40,000 package:** $12.60
|
||||
|
||||
### Scenario 4: High-Resolution Portfolio
|
||||
- **Need:** 10-slide 4K Nano Banana presentation
|
||||
- **Credits required:** 2,000 credits (10 pages × 200 credits)
|
||||
- **Cost with 4,000 package:** $4.75
|
||||
- **Cost with 40,000 package:** $4.00
|
||||
|
||||
### Scenario 5: Complete Package
|
||||
- **Need:** 25-slide 2K presentation with narration, exported as PNG/WAV
|
||||
- **Credits required:** 5,250 credits
|
||||
- Slides: 2,500 credits (25 pages × 100 credits)
|
||||
- Narration: 2,750 credits (25 pages × 110 credits - voice only)
|
||||
- Export: 0 credits (FREE)
|
||||
- **Cost with 10,000 package:** $11.81
|
||||
- **Cost with 40,000 package:** $10.50
|
||||
|
||||
## Payment Methods
|
||||
|
||||
Accepted payment methods via Stripe:
|
||||
- Major credit cards (Visa, Mastercard, American Express, Discover)
|
||||
- Apple Pay
|
||||
- Google Pay
|
||||
|
||||
## Refund Policy
|
||||
|
||||
- **3-day refund window** after purchase
|
||||
- Contact support through https://2slides.com for refund requests
|
||||
- Credits must not have been substantially used
|
||||
|
||||
## Enterprise & Team Plans
|
||||
|
||||
Currently in development. For high-volume or team needs, contact 2slides support through https://2slides.com.
|
||||
|
||||
## Checking Your Credit Balance
|
||||
|
||||
**Via Web:**
|
||||
1. Visit https://2slides.com/api
|
||||
2. Log in to your account
|
||||
3. View your dashboard for current credit balance and usage history
|
||||
|
||||
**Via API:**
|
||||
- Credit balance is returned in API error responses when insufficient
|
||||
- Check account page for detailed usage tracking
|
||||
|
||||
## Credit Expiration
|
||||
|
||||
**Credits NEVER expire.** Purchase credits and use them at your own pace without time pressure.
|
||||
|
||||
## Best Practices for Credit Management
|
||||
|
||||
1. **Start with free credits** - Use your 500 free credits to test features
|
||||
2. **Calculate needs** - Estimate your typical usage before purchasing
|
||||
3. **Buy in bulk** - Larger packages offer better value (up to 20% off)
|
||||
4. **Monitor usage** - Check your dashboard regularly to track consumption
|
||||
5. **Plan ahead** - Buy credits before you need them to take advantage of promotions
|
||||
|
||||
## Rate Limits
|
||||
|
||||
Credit purchases do not affect API rate limits:
|
||||
- Fast PPT: 10 requests per minute
|
||||
- Nano Banana: 6 requests per minute
|
||||
|
||||
Rate limits are based on API tier, not credit balance.
|
||||
|
||||
## Common Questions
|
||||
|
||||
**Q: Do credits expire?**
|
||||
A: No, credits never expire.
|
||||
|
||||
**Q: Can I get a refund?**
|
||||
A: Yes, within 3 days of purchase if credits haven't been substantially used.
|
||||
|
||||
**Q: What happens if I run out of credits?**
|
||||
A: API requests will return an INSUFFICIENT_CREDITS error. Purchase more credits to continue.
|
||||
|
||||
**Q: Can I share credits with my team?**
|
||||
A: Currently, credits are tied to individual API keys. Team plans are in development.
|
||||
|
||||
**Q: Are there discounts for students or nonprofits?**
|
||||
A: Contact 2slides support for special pricing inquiries.
|
||||
|
||||
**Q: How do I know how many credits I have left?**
|
||||
A: Check your dashboard at https://2slides.com/api
|
||||
|
||||
## Resources
|
||||
|
||||
- **Purchase Credits:** https://2slides.com/pricing
|
||||
- **API Dashboard:** https://2slides.com/api
|
||||
- **Main Website:** https://2slides.com
|
||||
- **API Documentation:** See api-reference.md
|
||||
- **Skill Guide:** See SKILL.md
|
||||
|
||||
---
|
||||
|
||||
*Pricing information last updated: 2026-02-10*
|
||||
Reference in New Issue
Block a user