SlideSpeak 演示文稿技能

此技能使您能够使用 SlideSpeak API 创建和编辑 PowerPoint 演示文稿。

重要：时间行为

演示文稿生成需要 30-60 秒。

选项 1：等待完成（默认）

运行命令并等待。脚本会在内部轮询直到完成：

node scripts/slidespeak.mjs generate --text "Topic"

• 阻塞直到任务完成（通常为 30-60 秒）
• 返回包含下载链接的完整结果

选项 2：立即返回，使用--no-wait

如果您无法等待命令完成，请使用--no-wait：

node scripts/slidespeak.mjs generate --text "Topic" --no-wait

立即返回以下信息：

{
  "success": true,
  "data": {
    "task_id": "abc123...",
    "message": "Task started. Check status with: node scripts/slidespeak.mjs status abc123..."
  }
}

然后轮询状态直到完成：

node scripts/slidespeak.mjs status <task_id>

当task_status为SUCCESS时，使用request_id下载。

超时行为

如果脚本在等待时超时，它会返回 task_id，以便您可以继续轮询：

{
  "success": true,
  "data": {
    "complete": false,
    "task_id": "abc123...",
    "task_status": "STARTED",
    "message": "Task still processing. Check status with: node scripts/slidespeak.mjs status abc123..."
  }
}

设置

必须设置SLIDESPEAK_API_KEY环境变量。从https://app.slidespeak.co/settings/developer

获取您的 API 密钥。

快速参考所有命令都使用位于scripts/slidespeak.mjs

的辅助脚本。该脚本处理 API 身份验证并自动等待异步任务完成（无需手动轮询）。

node scripts/slidespeak.mjs generate --text "Your topic or content" --length 6

从文本生成演示文稿

• 选项：--text
• （必需）：演示文稿的主题或内容--length
• ：幻灯片数量（默认值：10）--template
• ：模板名称或 ID（默认值：“default”）输出语言（默认："ORIGINAL"）
• --语气：休闲、专业、风趣、教育性、销售推广
• --详细程度：简洁、标准、文字密集
• --无图片：禁用获取库存图片
• --无封面：排除封面幻灯片
• --无目录：排除目录

从上传的文档生成

首先上传文档，然后生成：

# Upload a document (PDF, DOCX, PPTX, etc.)
node scripts/slidespeak.mjs upload /path/to/document.pdf

# Use the returned document_uuid to generate
node scripts/slidespeak.mjs generate --document <document_uuid> --length 10

支持的格式：.pdf、.docx、.doc、.pptx、.ppt、.xlsx,.txt,.md

列出可用模板

# Default templates
node scripts/slidespeak.mjs templates

# Branded templates (if configured)
node scripts/slidespeak.mjs templates --branded

下载演示文稿

生成完成后，使用request_id进行下载：

node scripts/slidespeak.mjs download <request_id>

返回一个包含短期有效下载URL的JSON对象。

编辑现有演示文稿

编辑现有演示文稿中的幻灯片：

# Insert a new slide at position 2
node scripts/slidespeak.mjs edit-slide \
  --presentation-id <id> \
  --type INSERT \
  --position 2 \
  --prompt "Content about market analysis"

# Regenerate slide at position 3
node scripts/slidespeak.mjs edit-slide \
  --presentation-id <id> \
  --type REGENERATE \
  --position 3 \
  --prompt "Updated content for this slide"

# Remove slide at position 4
node scripts/slidespeak.mjs edit-slide \
  --presentation-id <id> \
  --type REMOVE \
  --position 4

编辑类型：

• 插入：在指定位置添加新幻灯片
• 重新生成：替换现有幻灯片内容
• 移除：删除幻灯片（无需提示）

检查任务状态

用于调试或手动轮询：

node scripts/slidespeak.mjs status <task_id>

获取账户信息

node scripts/slidespeak.mjs me

逐页生成

如需精确控制每一页幻灯片，请使用逐页幻灯片端点。完整模式请参阅references/API.md。

node scripts/slidespeak.mjs generate-slides --config slides.json

其中slides.json包含：

{
  "slides": [
    {"title": "Introduction", "layout": "title", "content": "Welcome message"},
    {"title": "Key Points", "layout": "bullets", "item_amount": 4, "content": "Main discussion points"}
  ],
  "template": "default"
}

Webhooks

订阅以在任务完成时接收通知：

# Subscribe
node scripts/slidespeak.mjs webhook-subscribe --url "https://your-webhook.com/endpoint"

# Unsubscribe
node scripts/slidespeak.mjs webhook-unsubscribe --url "https://your-webhook.com/endpoint"

错误处理

脚本输出JSON，可能为以下两种格式之一：

• 成功：{"success": true, "data": {...}}
• 错误：{"success": false, "error": "message"}

常见工作流程

创建关于某个主题的演示文稿

node scripts/slidespeak.mjs generate --text "Introduction to Machine Learning" --length 8 --tone educational

从PDF报告创建演示文稿

# Upload the PDF
RESULT=$(node scripts/slidespeak.mjs upload report.pdf)
DOC_ID=$(echo $RESULT | jq -r '.data.document_uuid')

# Generate presentation
node scripts/slidespeak.mjs generate --document "$DOC_ID" --length 12

编辑演示文稿以添加新幻灯片

node scripts/slidespeak.mjs edit-slide \
  --presentation-id "abc123" \
  --type INSERT \
  --position 5 \
  --prompt "Add a slide about quarterly revenue growth with charts"

附加资源

如需获取包含所有参数、布局类型和限制的详细API文档，请阅读references/API.md。