2页PPT生成器

read -r -s SLIDES_2SLIDES_API_KEY
export SLIDES_2SLIDES_API_KEY

python -m pip install -r requirements.txt

用户请求
│
├─ "根据此内容/文本创建幻灯片"
│  └─> 使用基于内容的生成（第 1 节）
│
├─ "创建像这张图一样的幻灯片"
│  └─> 使用参考图生成（第 2 节）
│
├─ "创建自定义设计幻灯片" 或 "创建 PDF 幻灯片"
│  └─> 使用自定义 PDF 生成

---
1. 基于内容的生成
根据用户提供的文本内容生成幻灯片。
使用场景
用户在消息中直接提供内容
用户要求 "创建一个关于 X 的演示文稿"
用户提供了结构化的大纲或要点
工作流
步骤 1：准备内容
为了获得最佳效果，请清晰地组织内容结构：

步骤 2：选择主题（必填）

搜索合适的主题（必须提供 themeId）：

从结果中选择一个主题 ID。

步骤 3：生成幻灯片
使用 generate_slides.py 脚本并传入主题 ID：

步骤 4：处理结果
同步模式响应：

向用户提供这两个 URL：
slideUrl：在线交互式幻灯片

pdfUrl：可下载的 PDF 版本

异步模式响应：

轮询结果：

---

2. 基于参考图生成
生成与参考图像风格一致的幻灯片。
使用场景
用户提供图片 URL 并要求 "创建像这样的幻灯片"
用户希望匹配现有的品牌/设计风格
用户有想要模仿的模板图片
工作流
步骤 1：验证图片 URL
确保参考图片满足：
URL 公开可访问

格式有效（PNG, JPG 等）

代表了所需的幻灯片风格

步骤 2：生成幻灯片
使用 generate_slides.py 脚本并添加 --reference-image 参数：

可选参数（所有值均来自 2slides API）：

-resolution 1K|2K|4K            # 默认值: 2K
--page N                         # 0=自动, 1-100 (默认值: 1)
--content-detail concise|standard # 默认值: concise

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

标题：[主话题]
章节 1：[子话题]
关键点 1

关键点 2

章节 2：[子话题]
关键点 1

关键点 2

# 基础生成
python scripts/create_pdf_slides.py --content "此处输入内容"
指定设计风格 (API: designStyle)
python scripts/create_pdf_slides.py \
  --content "2025年第四季度销售报告" \
  --design-style "现代极简主义，蓝色调"
高分辨率且自动检测页数
python scripts/create_pdf_slides.py \
  --content "营销计划" \
  --resolution 4K \
  --page 0 \
  --content-detail standard

--design-style "text"           # 设计指令 (API: designStyle)
--language LANG                 # 与 generate_slides 相同 (默认值: Auto)
--aspect-ratio RATIO           # 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 (默认值: 16:9)
--resolution 1K|2K|4K          # 默认值: 2K
--page N                        # 0=自动, 1-100 (默认值: 1)
--content-detail concise|standard # 默认值: standard

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

标题：
[文档主旨]
引言
背景

目的

概览

[文档第 1 节]
关键点 1

关键点 2

支撑细节

[文档第 2 节]
关键点 1

关键点 2

支撑细节

结论
总结

核心要点

后续步骤

# 搜索合适的主题
python scripts/search_themes.py --query "business"
使用主题 ID 生成
python scripts/generate_slides.py --content "[步骤 3 中的结构化内容]" --theme-id "theme123"

python scripts/generate_narration.py --list-voices

# 使用默认声音进行基础旁白生成
python scripts/generate_narration.py --job-id "abc-123-def-456"
单一演讲者，指定声音
python scripts/generate_narration.py --job-id "abc-123-def-456" --voice Aoede
多角色模式
python scripts/generate_narration.py --job-id "abc-123-def-456" --multi-speaker

python scripts/get_job_status.py --job-id "abc-123-def-456"

# 使用默认文件名下载 (<job_id>.zip)
python scripts/download_slides_pages_voices

步骤 3：解压内容
ZIP 压缩包包含：
Pages： 每页幻灯片的 PNG 文件

Voices： WAV 音频文件（如果生成了旁白）

Transcripts： 旁白的文本转录

注意事项：
费用： 完全免费（不消耗积分）

下载链接有效期仅为 1 小时

包含所有页面和语音文件

高质量 PNG 导出

音频采用 WAV 格式

---
7. 主题搜索
为演示文稿寻找合适的主题。
使用场景
在生成具有特定风格的幻灯片之前
用户询问“有哪些可用主题？”
用户需要专业或品牌化的外观
工作流
搜索主题：

主题选择：
1. 向用户展示可用主题的名称和描述
2. 请用户选择或使用默认主题
3. 在生成请求中使用该主题 ID
---
使用 MCP 服务器
如果 Claude Desktop 中配置了 2slides MCP 服务器，请使用集成工具而非脚本。
两种配置模式：
1. 可流式传输的 HTTP 协议（推荐）
   - 设置最简单，无需本地安装
   - 配置："url": "https://2slides.com/api/mcp?apikey=YOUR_API_KEY"
2. NPM 包 (stdio)
   - 使用本地 npm 包
   - 配置："command": "npx", "args": ["2slides-mcp"]
可用 MCP 工具：
slides_generate - 根据内容生成幻灯片

slides_create_like_this - 根据参考图生成

themes_search - 搜索主题

jobs_get - 检查任务状态

完整设置指南和详细工具文档请参阅 mcp-integration.md。
何时使用 MCP 与脚本：
已配置时，在 Claude Desktop 中使用 MCP

在 Claude Code CLI 中或 MCP 不可用时使用脚本

---
高级功能
同步 vs 异步模式
同步模式（默认）：
等待生成完成（30-60 秒）

立即返回结果

适用于快速生成演示文稿

异步模式：
立即返回任务 ID (job ID)

使用 get_job_status.py 轮询结果

适用于大型演示文稿或批量处理

建议轮询频率： 每 20-30 秒检查一次，以避免给服务器带来压力

速率限制 (Rate Limits)
不同端点有不同的速率限制：
Fast PPT (generate)： 每分钟 10 次请求
Nano Banana (create-like-this, create-pdf-slides)： 每分钟 6 次请求
如果触发速率限制，请稍后重试或检查套餐限制。
积分消耗
Fast PPT (generate 端点)： 每页 10 积分
Nano Banana 1K/2K (create-like-this, create-pdf-slides)： 每页 100 积分
Nano Banana 4K： 每页 200 积分
语音旁白： 每页 210 积分（10 积分用于文本，200 积分用于音频）
下载导出： 免费（不消耗积分）
购买积分
2slides 采用按需付费的积分系统，无需订阅。
积分套餐：（当前促销：最高 20% 折扣）
2,000 积分：$5.00

4,000 积分：$9.50 (5% off)

10,000 积分：$22.50 (10% off)

20,000 积分

: $42.50 (85折)
40,000 积分: $80.00 (8折)

新用户可获得 500 免费积分用于上手体验（约可生成 50 页 Fast PPT）。
积分永不过期 —— 可根据您的节奏随时使用。
购买积分请访问： https://2slides.com/pricing
下载链接有效期
所有下载链接（PDF、ZIP 压缩包）的有效期仅为 1 小时。请在生成后及时下载文件。
语言支持
支持多种语言生成幻灯片（请使用语言全称）：

以及更多：阿拉伯语、葡萄牙语、印尼语、俄语、印地语、越南语、土耳其语、波兰语、意大利语。

错误处理
常见错误代码：
1. 缺失 API 密钥

2. RATE_LIMIT_EXCEEDED (超出速率限制)

3. INSUFFICIENT_CREDITS (积分不足)

4. INVALID_JOB_ID (无效的任务 ID)

5. Invalid content (内容无效)