2slides-ppt-generator - SKILL

name: 2slides-ppt-generator
description: “通过 2slides API 进行 AI 驱动的演示文稿生成——从文本创建幻灯片、匹配参考图片样式、将文档总结为演示文稿、添加 AI 语音旁白以及导出页面/音频。用于任何"制作幻灯片”、“创建演示文稿"或"从本文档生成幻灯片"的请求。”
category: api-integration
risk: safe
source: community
source_repo: 2slides/slides-generation-2slides-skills
source_type: community
date_added: “2026-06-05”
author: 2slides
tags: [presentations, slides, powerpoint, ai, api-integration, pdf, narration, document-summarization]
tools: [claude, cursor, gemini, codex, antigravity]
plugin:
setup:
type: manual
summary: “安装 Python 依赖项并在运行生成脚本之前配置 2slides API 密钥。”
docs: SKILL.md

2slides 演示文稿生成

概述

使用 2slides AI API 生成专业演示文稿。该技能支持基于内容的生成（主题驱动的快速 PPT）、从参考图片匹配样式、自定义 PDF 设计、文档总结、AI 语音旁白以及导出页面/音频。它返回交互式幻灯片 URL 和可下载的 PDF。

此技能改编自官方 2slides 技能仓库（2slides/slides-generation-2slides-skills）。它调用托管的 2slides API，需要用户自己的 API 密钥和点数。

何时使用此技能

• 当用户要求从文本或大纲"创建演示文稿"、"制作幻灯片"或"生成演示文稿"时使用。
• 当用户想要与参考图片样式匹配的幻灯片时使用（“创建像这张图片一样的幻灯片”）。
• 当用户想要没有参考图片的自定义设计的 PDF 幻灯片时使用。
• 当用户上传文档并说"从本文档创建幻灯片"时使用。
• 当用户想要为生成的幻灯片添加 AI 语音旁白，或将幻灯片导出为 PNG 图像、将旁白导出为 WAV 音频时使用。
• 当用户问"有哪些主题可用？"或想要浏览/选择主题时使用。

设置要求

用户必须拥有 2slides API 密钥和点数：

1. 获取 API 密钥：访问 https://2slides.com/api 创建账户和 API 密钥
   • 新用户可获得500 个免费点数（约 50 页快速 PPT）
2. 购买点数（可选）：访问 https://2slides.com/pricing 购买额外点数
   • 按需付费，无需订阅
   • 点数永不过期
   • 大额套餐最高可享 20% 折扣
3. 设置 API 密钥：将密钥存储在环境变量中：SLIDES_2SLIDES_API_KEY

read-r-sSLIDES_2SLIDES_API_KEYexportSLIDES_2SLIDES_API_KEY

4. 安装脚本依赖：在此技能目录中，使用 Python 脚本前先安装锁定的本地依赖：

python-mpipinstall-rrequirements.txt

点数成本：

• 快速 PPT：10 点数/页
• Nano Banana 1K/2K：100 点数/页
• Nano Banana 4K：200 点数/页
• 语音旁白：210 点数/页
• 下载导出：免费

查看 references/pricing.md 获取详细定价信息。

工作流决策树

根据用户的请求选择合适的方法：

用户请求 │ ├─ "从这些内容/文本创建幻灯片" │ └─> 使用基于内容的生成（第 1 节） │ ├─ "创建像这张图片一样的幻灯片" │ └─> 使用参考图片生成（第 2 节） │ ├─ "创建自定义设计的幻灯片" 或 "创建 PDF 幻灯片" │ └─> 使用自定义 PDF 生成（第 3 节） │ ├─ "从本文档创建幻灯片" │ └─> 使用文档总结（第 4 节） │ ├─ "添加语音旁白" 或 "为幻灯片生成音频" │ └─> 使用语音旁白（第 5 节） │ ├─ "下载幻灯片为图片" 或 "导出幻灯片和语音" │ └─> 使用下载导出（第 6 节） │ └─ "搜索主题" 或 "有哪些主题可用？" └─> 使用主题搜索（第 7 节）

1. 基于内容的生成

从用户提供的文本内容生成幻灯片。

何时使用

• 用户直接在消息中提供内容
• 用户说"创建关于 X 的演示文稿"
• 用户提供结构化大纲或要点

工作流

步骤 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：生成幻灯片

使用带有主题 ID 的generate_slides.py脚本：

# 基本生成（需要主题 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"--modeasync

步骤 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"

2. 参考图片生成

生成与参考图片样式匹配的幻灯片。

何时使用

• 用户提供图片 URL 并说"创建像这样的幻灯片"
• 用户想要匹配现有品牌/设计风格
• 用户有想要模仿的模板图片

工作流

步骤 1：验证图片 URL

确保参考图片：

• 是可公开访问的 URL
• 是有效的图片格式（PNG、JPG 等）
• 代表所需的幻灯片样式

步骤 2：生成幻灯片

使用带有--reference-image的generate_slides.py脚本：

python scripts/generate_slides.py\--content"你的演示文稿内容"\--reference-image"https://example.com/template.jpg"\--language"Auto"

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

--languageLANG# Auto、English、Spanish、Arabic、Portuguese、Indonesian、# Japanese、Russian、Hindi、French、German、Greek、Vietnamese、# Turkish、Polish、Italian、Korean、Simplified Chinese、# Traditional Chinese、Thai（默认：Auto）--modesync|async# 默认：sync 用于主题，async 用于参考图片--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）--resolution1K|2K|4K# 默认：2K--pageN# 0=自动，1-100（默认：1）--content-detail concise|standard# 默认：concise

注意：这使用 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 秒）

3. 自定义 PDF 生成

从文本生成自定义设计的幻灯片，无需参考图片。

何时使用

• 用户想要自定义设计但未提供参考图片
• 用户请求"创建 PDF 幻灯片"
• 用户想要指定设计特征
• 作为基于主题的生成的替代方案，具有更多设计灵活性

工作流

步骤 1：准备内容

清晰组织内容：

标题：[主主题] 第 1 节：[子主题] - 关键点 1 - 关键点 2 第 2 节：[子主题] - 关键点 1 - 关键点 2

步骤 2：生成幻灯片

使用create_pdf_slides.py脚本：

# 基本生成python scripts/create_pdf_slides.py--content"你的内容"# 带设计风格（API：designStyle）python scripts/create_pdf_slides.py\--content"2025 年 Q4 销售报告"\--design-style"现代简约，蓝色配色方案"# 高分辨率，自动页面检测python scripts/create_pdf_slides.py\--content"营销计划"\--resolution4K\--page0\--content-detail standard

可选参数：

--design-style"text"# 设计说明（API：designStyle）--languageLANG# 同 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）--resolution1K|2K|4K# 默认：2K--pageN# 0=自动，1-100（默认：1）--content-detail concise|standard# 默认：standard

步骤 3：处理结果

返回与 create-like-this 相同的结构：

{"slideUrl":"https://2slides.com/workspace?jobId=...","pdfUrl":"https://...pdf...","status":"completed","message":"成功生成 N 张幻灯片","slidePageCount":N}

注意：

• 与 create-like-this 相同的点数成本（1K/2K 每页 100 点数，4K 每页 200 点数）
• 处理时间：每页约 30 秒
• 自动生成 PDF
• 使用 AI 根据内容和规格创建自定义设计

4. 文档总结

从文档内容生成幻灯片。

何时使用

• 用户上传文档（PDF、DOCX、TXT 等）
• 用户说"从本文档创建幻灯片"
• 用户想要将长内容总结为演示文稿格式

工作流

步骤 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 个要点）
• 聚焦关键洞察，而非全文
• 使用文档标题作为幻灯片标题
• 包含重要统计数据或引用
• 询问用户是否需要突出显示特定部分

5. 语音旁白

为幻灯片添加 AI 生成的语音旁白。

何时使用

• 用户想要为幻灯片添加音频
• 用户请求"添加语音旁白"或"生成音频"
• 用户想要带口头内容的演示文稿
• 用户需要多说话人旁白

前提条件

重要：在添加旁白之前，幻灯片生成作业必须已完成。

1. 先使用任何方法（第 1、2、3 或 4 节）生成幻灯片
2. 从生成结果中获取作业 ID
3. 在请求旁白前确保作业状态为"已完成"

工作流

步骤 1：选择语音

30 种语音可用，包括：

• Puck（默认）
• Aoede
• Charon
• Kore
• Fenrir
• Phoebe
• 以及另外 24 种…

列出所有语音：

python scripts/generate_narration.py --list-voices

步骤 2：生成旁白

使用带有作业 ID 的generate_narration.py脚本：

# 使用默认语音的基本旁白python scripts/generate_narration.py --job-id"abc-123-def-456"# 单说话人，指定语音python scripts/generate_narration.py --job-id"abc-123-def-456"--voiceAoede# 多说话人模式python scripts/generate_narration.py --job-id"abc-123-def-456"--multi-speaker

参数（与 2slides API 对齐）：

• --job-id：作业 ID（必需，Nano Banana 使用 UUID）
• --voice：语音名称（默认：Puck）；使用--list-voices查看全部 30 种
• --language：旁白语言（默认：Auto）
• --multi-speaker：启用多说话人模式
• --list-voices：列出支持的语音而不调用 API

步骤 3：检查状态

旁白生成异步运行：

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

步骤 4：处理结果

完成后，作业将包含旁白文件。使用下载端点（第 6 节）获取音频文件。

注意：

• 成本：每页 210 点数（10 用于文本，200 用于音频）
• 处理时间因幻灯片数量而异
• 提供 30 种语音选项
• 支持 19 种语言加自动检测
• 多说话人模式使用不同语音增加多样性

6. 下载导出

将幻灯片下载为 PNG 图像，将语音旁白下载为 WAV 文件。

何时使用

• 用户想要将幻灯片下载为图片
• 用户需要单独的语音文件
• 用户想要文字记录
• 用户需要其他工具所需的图片格式的幻灯片

工作流

步骤 1：确认作业完成

确保幻灯片（以及可选的旁白）已生成且作业已完成。

步骤 2：下载归档文件

使用download_slides_pages_voices.py脚本：

# 使用默认文件名下载（<job_id>.zip）python scripts/download_slides_pages_voices.py --job-id"abc-123-def-456"# 下载到指定路径python scripts/download_slides_pages_voices.py\--job-id"abc-123-def-456"\--output"my-presentation.zip"

步骤 3：解压内容

ZIP 归档文件包含：

• 页面：每张幻灯片的 PNG 文件
• 语音：WAV 音频文件（如果生成了旁白）
• 文字记录：旁白的文本转录

注意：

• 成本：完全免费（不消耗点数）
• 下载 URL 仅在1 小时内有效
• 包含所有页面和语音文件
• 高质量 PNG 导出
• 音频为 WAV 格式

7. 主题搜索

查找适合演示文稿的主题。

何时使用

• 在生成具有特定样式的幻灯片之前
• 用户问"有哪些主题可用？"
• 用户想要专业或品牌化的外观

工作流

搜索主题：

# 搜索特定风格（需要查询参数）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"--limit50

主题选择：

1. 向用户展示可用主题的名称和描述
2. 让用户选择或使用默认主题
3. 在生成请求中使用主题 ID

使用 MCP 服务器

如果 2slides MCP 服务器已在 Claude Desktop 中配置，请使用集成工具代替脚本。

两种配置模式：

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 vs 脚本：

• 在 Claude Desktop 中使用 MCP（如果已配置）
• 在 Claude Code CLI 中使用脚本（或 MCP 不可用时）

高级功能

同步 vs 异步模式

同步模式（默认）：

• 等待生成完成（30-60 秒）
• 立即返回结果
• 最适合快速演示文稿

异步模式：

• 立即返回作业 ID
• 使用get_job_status.py轮询结果
• 最适合大型演示文稿或批量处理
• 推荐轮询频率：每 20-30 秒检查一次，避免服务器压力

速率限制

不同端点有不同的速率限制：

• 快速 PPT（生成）：每分钟 10 个请求
• Nano Banana（create-like-this、create-pdf-slides）：每分钟 6 个请求

如果被限制，等待后重试或检查套餐限制。

点数成本

• 快速 PPT（生成端点）：每页 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% 折扣）
• 10,000 点数：$22.50（10% 折扣）
• 20,000 点数：$42.50（15% 折扣）
• 40,000 点数：$80.00（20% 折扣）

新用户可获得 500 个免费点数用于入门（约 50 页快速 PPT）。

点数永不过期- 按自己的节奏使用。

购买点数：https://2slides.com/pricing

下载 URL 过期

所有下载 URL（PDF、ZIP 归档文件）仅在1 小时内有效。生成后请及时下载文件。

语言支持

以多种语言生成幻灯片（使用完整的语言名称）：

--language"Auto"# 自动检测（默认）--language"English"# 英语--language"Simplified Chinese"# 简体中文--language"Traditional Chinese"# 繁體中文--language"Spanish"# 西班牙语--language"French"# 法语--language"German"# 德语--language"Japanese"# 日语--language"Korean"# 韩语

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

错误处理

常见错误代码：

1. 缺少 API 密钥

   Error: API key not found Solution: Set SLIDES_2SLIDES_API_KEY environment variable

2. RATE_LIMIT_EXCEEDED

   Error: 429 Too Many Requests Solution: Wait 20-30 seconds before retrying Rate limits: Fast PPT (10/min), Nano Banana (6/min)

3. INSUFFICIENT_CREDITS

   Error: Not enough credits Solution: Add credits at https://2slides.com/api

4. INVALID_JOB_ID

   Error: Job ID not found or invalid Solution: Verify job ID format (must be UUID for Nano Banana)

5. 无效内容

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

脚本参数参考（2slides API）

所有脚本接受的参数与 2slides API 匹配。允许的值在scripts/api_constants.py中定义并在适用时强制执行。

附加文档

API 参考

查看 api-reference.md 了解：

• 所有端点和参数
• 请求/响应格式
• 认证详情
• 速率限制和最佳实践
• 错误代码和处理

定价信息

查看 pricing.md 了解：

• 点数套餐和定价
• 成本示例和计算
• 免费试用详情
• 退款政策
• 企业选项

最佳结果提示

内容结构：

• 使用清晰的标题和副标题
• 保持要点简洁
• 每节限制 3-5 个要点
• 包含相关示例或数据

主题选择：

• 标准生成需要主题 ID
• 使用与演示文稿目的匹配的关键词搜索
• 常见搜索：“business”、“professional”、“creative”、“education”、“modern”
• 每个主题都有独特的样式和布局

参考图片：

• 使用高质量图片以获得最佳效果
• 可以使用 URL 或 base64 编码的图片
• 公开的 URL 必须可访问
• 根据质量需求考虑分辨率设置（1K/2K/4K）
• 使用 page=0 进行自动幻灯片数量检测

文档处理：

• 仅提取关键信息
• 不要试图将整个文档塞进幻灯片
• 聚焦主要洞察和要点
• 询问用户哪些部分需要强调

安全与注意事项

• 凭证：此技能从SLIDES_2SLIDES_API_KEY环境变量读取 API 密钥。切勿将密钥硬编码在命令中、提交到版本控制或回显给用户。脚本通过 HTTPS 仅将其作为 bearer/apikey值发送到https://2slides.com。
• 网络 + 付费操作：每次生成调用都会向 2slides API 发出出站网络请求并消耗用户的点数（根据模式，每页 10-210 点数）。将生成、参考图片、自定义 PDF 和旁白调用视为计费操作 — 在生成大型或高分辨率（4K）演示文稿前确认意图，并在非平凡情况下告知预期页数/成本。
• 无破坏性本地操作：脚本仅读取用户指定的内容/文件，并将生成的输出（例如下载的 ZIP）写入用户指定的路径。它们不会修改或删除无关文件。
• 输入处理：参考图片和文档输入将发送到 2slides 服务进行处理。请勿提交用户未授权第三方处理的机密材料。
• 下载 URL 1 小时后过期— 及时获取构件，不要将 URL 视为持久存储。

限制

• 需要有效的 2slides 账户、API 密钥和足够的点数；此技能不提供或支付点数。
• 结果是 AI 生成的草稿，作为起点而非最终经过事实核查的交付物 — 使用前请审查内容。
• 此技能不替代环境特定的验证或专家审查。如果 API 密钥、所需输入或预期成本/范围缺失，请停止并请求澄清。
• 适用速率限制（快速 PPT 每分钟 10 次，Nano Banana 每分钟 6 次）；每 20-30 秒轮询异步作业，而非紧密循环。

相关技能

• @youtube-full— 获取可总结为此技能演示文稿的源材料（转录文本）。