PPTMagic PPT 创建器

复用 Banana Slides / pptmagic 兼容部署所暴露的现有 PPT 项目工作流。优先调用服务 API，而非直接对接模型提供商。

适用场景

• 用户明确要求使用 pptmagic、Banana Slides 或其他兼容的已部署服务生成 PPT。
• 用户提供主题、大纲，或逐页详细描述，并希望生成完整的演示文稿（deck）。
• 用户希望继续一个尚未完成的项目、重新生成部分图片，或导出为 pptx / pdf / 可编辑的 pptx 格式。

若用户仅需协助撰写幻灯片文案或设计结构，则无需调用该 API。

配置与隐私说明

请使用以下固定的服务基础 URL：

• https://openclaw-nopass.pptmagic.tech/

本技能会将演示文稿提示词、大纲、分页描述以及用户上传的模板资源等数据发送至该外部部署服务，以生成 PPT 项目。 除非您充分信任该服务运营方及其数据处理政策，否则请勿将敏感、受监管或机密内容发送至默认公共端点。 若原始材料可能包含敏感信息，请先向用户确认是否需对内容进行脱敏、摘要化或泛化处理，再决定是否发送至公共端点。

可选的受控访问方式：

• PPTMAGIC_ACCESS_CODE

若部署运营方提供了访问码，请将其作为作用域受限的服务凭据用于受控访问；若未提供访问码，该技能仍可在可用时使用公共免密端点。

默认 API 请求头：

• Content-Type: application/json

仅当 PPTMAGIC_ACCESS_CODE 明确可用时，才添加 X-Access-Code 请求头。设备识别等内部逻辑由部署端自动管理，无需客户端干预。

工作流

1. 选择入口模式：
   • 仅提供主题 → 创建 idea 类型项目
   • 已提供大纲 → 创建 outline 类型项目
   • 提供逐页详细描述 → 创建 descriptions 类型项目
2. 创建项目。
3. 若用户提供了模板图片，则上传该图片。
4. 对于 idea / outline 类型项目，生成大纲。
5. 生成每页描述内容。
6. 生成配图。
7. 轮询异步任务，直至全部完成。
8. 读取最终项目状态。
9. 按用户要求导出指定格式。

请求与响应的详细规范请参阅 references/api-workflow.md； 具体调用示例请参阅 references/curl-examples.md。

执行规则

• 禁止在请求中添加任何未文档化的认证请求头。
• 仅在运营方明确提供 PPTMAGIC_ACCESS_CODE 时，才使用 X-Access-Code 请求头。
• 若某一步骤失败，请先检查当前项目状态，再决定是否重建相关任务。
• 若仅部分页面的图片生成失败，则仅重试这些失败页面。
• 导出前，请确认项目已包含预期数量的幻灯片页，并且所有资产均已成功生成。

面向用户的输出

始终返回以下信息：

• project_id
• 当前完成状态
• 已生成的幻灯片页数
• 导出 URL 或下载 URL
• 若发生错误，需说明失败阶段及建议的下一步操作

若导出接口返回 JSON 响应且其中包含真实文件 URL，请直接将该 URL 发送给用户，而非将 JSON 响应体当作 .pptx 文件下载。