名称: 2slides
描述: 使用 2slides API 进行 AI 驱动的演示文稿生成。可从文本内容创建幻灯片、匹配参考图像风格或将文档总结为演示文稿。当用户请求“创建演示文稿”、“制作幻灯片”、“生成幻灯片”、“根据此内容/文档/图像创建幻灯片”或任何演示文稿创建任务时使用。支持主题选择、多语言以及同步和异步生成模式。
使用 2slides AI API 生成专业的演示文稿。支持基于内容的生成、从参考图像匹配风格以及文档摘要。
用户必须拥有 2slides API 密钥:
SLIDES_2SLIDES_API_KEYexport SLIDES_2SLIDES_API_KEY="your_api_key_here"
根据用户请求选择合适的方法:
用户请求
│
├─ “根据此内容/文本创建幻灯片”
│ └─> 使用基于内容的生成(第 1 节)
│
├─ “创建类似此图像的幻灯片”
│ └─> 使用参考图像生成(第 2 节)
│
├─ “根据此文档创建幻灯片”
│ └─> 使用文档摘要(第 3 节)
│
└─ “搜索主题” 或 “有哪些可用的主题?”
└─> 使用主题搜索(第 4 节)
根据用户提供的文本内容生成幻灯片。
步骤 1:准备内容
为获得最佳结果,请清晰构建内容结构:
标题:[主主题]
第 1 部分:[子主题]
- 要点 1
- 要点 2
- 要点 3
第 2 部分:[子主题]
- 要点 1
- 要点 2
步骤 2:选择主题(必需)
搜索合适的主题(themeId 是必需的):
python scripts/search_themes.py --query "business"
python scripts/search_themes.py --query "professional"
python scripts/search_themes.py --query "creative"
从结果中选择一个主题 ID。
步骤 3:生成幻灯片
使用 generate_slides.py 脚本并指定主题 ID:
# 基本生成(需要主题 ID)
python scripts/generate_slides.py --content "您的内容在此" --theme-id "theme123"
# 使用不同语言
python scripts/generate_slides.py --content "您的内容" --theme-id "theme123" --language "Spanish"
# 异步模式,适用于较长的演示文稿
python scripts/generate_slides.py --content "您的内容" --theme-id "theme123" --mode async
步骤 4:处理结果
同步模式响应:
{
"slideUrl": "https://2slides.com/slides/abc123",
"pdfUrl": "https://2slides.com/slides/abc123/download",
"status": "completed"
}
向用户提供两个 URL:
- slideUrl:在线交互式幻灯片
- pdfUrl:可下载的 PDF 版本
异步模式响应:
{
"jobId": "job123",
"status": "pending"
}
轮询结果:
python scripts/get_job_status.py --job-id "job123"
生成与参考图像风格匹配的幻灯片。
步骤 1:验证图像 URL
确保参考图像满足:
- 可公开访问的 URL
- 有效的图像格式(PNG、JPG 等)
- 代表所需的幻灯片风格
步骤 2:生成幻灯片
使用 generate_slides.py 脚本并指定 --reference-image:
python scripts/generate_slides.py \
--content "您的演示文稿内容" \
--reference-image "https://example.com/template.jpg" \
--language "Auto"
可选参数:
--aspect-ratio "16:9" # 宽高比格式(例如 "16:9"、"4:3")
--resolution "2K" # "1K"、"2K"(默认)或 "4K"
--page 5 # 幻灯片数量(0 表示自动检测,最多 100)
--content-detail "concise" # "concise"(简洁)或 "standard"(详细)
注意: 此模式使用 Nano Banana Pro 模式,会产生积分成本:
- 1K/2K:每页 100 积分
- 4K:每页 200 积分
步骤 3:处理结果
此模式始终以同步方式运行并返回:
{
"slideUrl": "https://2slides.com/workspace?jobId=...",
"pdfUrl": "https://...pdf...",
"status": "completed",
"message": "成功生成 N 张幻灯片",
"slidePageCount": N
}
向用户提供两个 URL:
- slideUrl:在 2slides 工作区查看幻灯片
- pdfUrl:直接下载 PDF(1 小时后过期)
处理时间: 每页约 30 秒(1-2 页通常为 30-60 秒)
根据文档内容生成幻灯片。
步骤 1:读取文档
使用适当的工具读取文档内容:
- PDF:使用 PDF 阅读工具
- DOCX:使用 DOCX 阅读工具
- TXT/MD:使用 Read 工具
步骤 2:提取关键点
分析文档并提取:
- 主要主题和要点
- 每个部分的关键点
- 重要的数据、引用或示例
- 逻辑流程和结构
步骤 3:构建内容
将提取的信息格式化为演示文稿结构:
标题:[文档主主题]
引言
- 背景
- 目的
- 概述
[文档中的第 1 部分]
- 关键点 1
- 关键点 2
- 支持性细节
[文档中的第 2 部分]
- 关键点 1
- 关键点 2
- 支持性细节
结论
- 总结
- 关键要点
- 后续步骤
步骤 4:生成幻灯片
使用基于内容的生成工作流(第 1 节)。首先搜索主题,然后生成:
# 搜索合适的主题
python scripts/search_themes.py --query "business"
# 使用主题 ID 生成
python scripts/generate_slides.py --content "[来自步骤 3 的结构化内容]" --theme-id "theme123"
提示:
- 保持幻灯片简洁(每张幻灯片 3-5 个要点)
- 专注于关键见解,而非全文
- 使用文档标题作为幻灯片标题
- 包含重要的统计数据或引用
- 询问用户是否要突出显示特定部分
为演示文稿查找合适的主题。
搜索主题:
# 搜索特定风格(query 是必需的)
python scripts/search_themes.py --query "business"
python scripts/search_themes.py --query "creative"
python scripts/search_themes.py --query "education"
python scripts/search_themes.py --query "professional"
# 获取更多结果
python scripts/search_themes.py --query "modern" --limit 50
主题选择:
如果在 Claude Desktop 中配置了 2slides MCP 服务器,请使用集成的工具而非脚本。
两种配置模式:
可流式传输的 HTTP 协议(推荐)
"url": "https://2slides.com/api/mcp?apikey=YOUR_API_KEY"NPM 包(stdio)
"command": "npx", "args": ["2slides-mcp"]可用的 MCP 工具:
- slides_generate - 根据内容生成幻灯片
- slides_create_like_this - 根据参考图像生成
- themes_search - 搜索主题
- jobs_get - 检查作业状态
完整设置说明和详细工具文档请参阅 mcp-integration.md。
何时使用 MCP 与脚本:
- 使用 MCP:在 Claude Desktop 中配置后使用
- 使用脚本:在 Claude Code CLI 中或 MCP 不可用时使用
同步模式(默认):
- 等待生成完成(30-60 秒)
- 立即返回结果
- 适用于快速演示文稿
异步模式:
- 立即返回作业 ID
- 使用 get_job_status.py 轮询结果
- 适用于大型演示文稿或批量处理
以多种语言生成幻灯片(使用完整语言名称):
--language "Auto" # 自动检测(默认)
--language "English" # 英语
--language "Simplified Chinese" # 简体中文
--language "Traditional Chinese" # 繁體中文
--language "Spanish" # 西班牙语
--language "French" # 法语
--language "German" # 德语
--language "Japanese" # 日语
--language "Korean" # 韩语
以及更多:阿拉伯语、葡萄牙语、印度尼西亚语、俄语、印地语、越南语、土耳其语、波兰语、意大利语
常见问题:
缺少 API 密钥
错误:未找到 API 密钥
解决方案:设置 SLIDES_2SLIDES_API_KEY 环境变量
速率限制
错误:429 请求过多
解决方案:等待后重试或检查计划限制
无效内容
错误:400 错误请求
解决方案:验证内容格式和参数
详细的 API 文档请参阅 api-reference.md
包括:
- 所有端点和参数
- 请求/响应格式
- 身份验证详情
- 速率限制和最佳实践
- 错误代码和处理
内容结构:
- 使用清晰的标题和副标题
- 保持要点简洁
- 每部分限制在 3-5 个要点
- 包含相关示例或数据
主题选择:
- 标准生成需要主题 ID
- 使用与演示文稿目的匹配的关键词搜索
- 常见搜索词:"business"、"professional"、"creative"、"education"、"modern"
- 每个主题都有独特的样式和布局
参考图像:
- 使用高质量图像以获得最佳效果
- 可以使用 URL 或 base64 编码图像
- 公共 URL 必须可访问
- 根据质量需求考虑分辨率设置(1K/2K/4K)
- 使用 page=0 进行自动幻灯片数量检测
文档处理:
- 仅提取关键信息
- 不要试图将整个文档放入幻灯片
- 专注于主要见解和要点
- 询问用户要强调哪些部分