prezentit：立即生成精美的 AI 驱动演示文稿

---
名称： prezentit
**描述：** 即时生成美观的AI演示文稿。通过自然语言指令，创建具有自定义主题、视觉设计和演讲者备注的专业幻灯片。
**主页：** https://prezentit.net
emoji: "👽"
**元数据：**
  clawdbot:
    emoji: "👽"
    skillKey: prezentit
    homepage: https://prezentit.net
    requires:
      config:
        - PREZENTIT_API_KEY
    config:
      requiredEnv:
        - name: PREZENTIT_API_KEY
          description: 您的Prezentit API密钥（以pk_开头）。免费获取：https://prezentit.net/api-keys
      example: |
        export PREZENTIT_API_KEY=pk_your_api_key_here
    permissions:
      network:
        - https://prezentit.net/api/v1/*
      fileSystem: none
      env:
        reads:
          - PREZENTIT_API_KEY
        writes: none
---

# Prezentit - AI演示文稿生成器

**基础URL**: `https://prezentit.net/api/v1`
**认证头**: `Authorization: Bearer {PREZENTIT_API_KEY}`

> **此技能需要设置 `PREZENTIT_API_KEY` 环境变量。** 在 https://prezentit.net/api-keys 免费获取API密钥——新账户包含100个免费积分。

## ⚠️ 对AI代理至关重要

**务必在生成请求中使用 `"stream": false`！** 否则将收到流式响应，可能导致问题。

---

## 完整工作流程（请按此顺序操作）

### 步骤 1：首先检查积分

```http
GET /api/v1/me/credits
Authorization: Bearer {PREZENTIT_API_KEY}

响应：

{
  "credits": 100,
  "pricing": {
    "outlinePerSlide": 5,
    "designPerSlide": 10,
    "estimatedCostPerSlide": 15
  },
  "_ai": {
    "canGenerate": true,
    "maxSlidesAffordable": 6,
    "nextSteps": ["..."]
  }
}

→ 如果 _ai.canGenerate 为 false，请引导用户前往 https://prezentit.net/buy-credits
→ 使用 _ai.maxSlidesAffordable 了解可生成的幻灯片数量上限

步骤 2：选择主题

选项 A — 浏览所有可用主题并按ID选择：

GET /api/v1/themes
Authorization: Bearer {PREZENTIT_API_KEY}

响应：

{
  "themes": [
    { "id": "corporate_blue", "name": "企业蓝", "category": "企业 & 专业" },
    { "id": "nature_earth", "name": "自然大地", "category": "自然 & 有机" }
  ],
  "categories": ["企业 & 专业", "创意 & 视觉", "数据 & 分析", ...],
  "_ai": {
    "totalThemes": 20,
    "popularThemes": ["corporate_blue", "midnight_tech", "nature_earth", "storyteller", "data_dashboard"]
  }
}

→ 在生成请求中使用确切的 id 值

选项 B — 通过关键词搜索主题：

GET /api/v1/themes?search=minimalist
Authorization: Bearer {PREZENTIT_API_KEY}

→ 返回按相关性排序的最佳匹配。使用 bestMatch 中的 id。

选项 C — 描述自定义样式（无需主题ID）：

使用 customDesignPrompt 参数代替。请参阅下方的自定义设计提示部分。

步骤 3：生成演示文稿

POST /api/v1/presentations/generate
Authorization: Bearer {PREZENTIT_API_KEY}
Content-Type: application/json

{
  "topic": "用户主题",
  "slideCount": 5,
  "theme": "corporate_blue",
  "stream": false
}

⏱️ 重要：生成过程需要1-3分钟。API将在完成后返回结果。

完整请求参数：

*即使提供了 outline，topic 也是必需的（用于演示文稿元数据）。

步骤 4：获取结果

成功响应：

{
  "presentationId": "uuid-here",
  "viewUrl": "https://prezentit.net/view/abc123",
  "creditsUsed": 75,
  "remainingCredits": 25
}

→ 将 viewUrl 分享给用户。这就是他们的演示文稿！

步骤 5：下载（可选）

GET /api/v1/presentations/{presentationId}/download?format=pptx
Authorization: Bearer {PREZENTIT_API_KEY}

格式： pptx (PowerPoint), pdf, json (原始数据)

定价

• 新账户获得 100 免费积分
• 购买更多积分：https://prezentit.net/buy-credits

主题选择

如何选择主题

1. 获取主题列表：GET /api/v1/themes — 返回所有可用主题及其 id、name 和 category
2. 根据用户主题和风格偏好选择最佳匹配
3. 在生成请求中将 id 作为 theme 参数传递

您也可以搜索：GET /api/v1/themes?search=关键词 或按类别筛选：GET /api/v1/themes?category=类别名称

自定义设计提示（跳过主题列表）

如果没有现有主题合适，使用 customDesignPrompt 来描述完全自定义的视觉样式。这必须是一个详细、结构化的描述——不仅仅是调色板。

自定义设计提示的必需结构（包含以下所有部分）：

颜色系统：主色 [十六进制]，辅色 [十六进制]，强调色 [十六进制]，背景 [十六进制/渐变]，标题和正文的文本颜色。

字体排版：标题字体样式 [例如，粗体几何无衬线字体如 Montserrat]，正文字体样式 [例如，清晰的人文主义无衬线字体如 Open Sans]，字号层级 [大/中/小]，字重对比。

布局系统：幻灯片结构 [例如，非对称分割，内容与视觉比例为60/40]，对齐方式 [左对齐文本与右侧视觉面板]，间距理念 [充足留白 vs. 密集信息]，网格方法。

视觉元素：背景处理 [纯色/渐变/纹理/图案]，装饰图案 [几何形状、有机曲线、线条艺术等]，图像风格 [带叠加的摄影、插图、图标、数据可视化]，边框/框架处理。

情绪与基调：整体美学 [例如，企业权威、趣味创意、学术严谨、科技前沿]，能量水平 [平静/动态/大胆]，预期受众印象。

示例 — 好的自定义设计提示：

{
  "topic": "AI在医疗保健中的应用",
  "customDesignPrompt": "颜色系统：主色为深医疗蓝 (#1B3A5C)，辅色为蓝绿色 (#2A9D8F)，强调色为暖珊瑚色 (#E76F51) 用于标注，背景在纯白色 (#FAFAFA) 和非常浅的蓝灰色 (#F0F4F8) 之间交替，标题文本为深海军蓝，正文文本为 #333333。字体排版：标题使用粗体几何无衬线字体（Montserrat风格），正文使用清晰的人文主义无衬线字体（Source Sans风格），强烈的字号层级，标题48pt，副标题24pt，正文16pt。布局系统：非对称布局，内容与视觉比例为60/40，左对齐文本块与右侧数据可视化或医疗图像，充足的边距（60px），干净的网格结构。视觉元素：角落处有5%不透明度的DNA螺旋水印，细蓝绿色强调线作为区域分隔线，小型装饰性医疗图标（听诊器、心跳、分子结构），全出血背景使用带蓝色调叠加的摄影图像。情绪与基调：专业的医疗权威感与平易近人的温暖感平衡，平静且值得信赖，专为医院高管和医疗专业人员设计。",
  "stream": false
}

示例 — 差的自定义设计提示（过于模糊，将产生通用结果）：

"蓝色和白色的医疗主题"

创建大纲（节省约33%积分）

提供自己的大纲可以节省积分，并让您完全控制内容。

大纲结构

大纲是一个包含 slides 数组的对象。每张幻灯片包含以下字段：

{
  "topic": "您的演示文稿主题",
  "outline": {
    "slides": [
      {
        "title": "幻灯片标题",
        "mainIdea": "一个清晰的句子，解释本幻灯片的核心理念以及听众应从中获得什么。",
        "talkingPoints": [
          "第一个关键点，包含足够细节以有意义（至少10个字符）",
          "第二个关键点，扩展核心理念",
          "第三个关键点，提供支持证据或示例"
        ],
        "visualGuide": "视觉布局的详细描述：背景风格、图像位置、图标建议、图表类型、颜色强调区域以及此特定幻灯片的装饰元素。"
      }
    ]
  },
  "stream": false
}

幻灯片字段参考

验证规则

总体：
- 最少 3张 幻灯片，最多 50张 幻灯片
- topic 仍然是必需的（用于演示文稿元数据）
- 每张幻灯片都需要所有四个字段（title、mainIdea、talkingPoints、visualGuide）

如果验证失败，API将返回包含 fix 建议的详细错误消息。

完整示例

{
  "topic": "机器学习入门",
  "outline": {
    "slides": [
      {
        "title": "机器学习入门",
        "mainIdea": "机器学习正在改变企业的运营方式，使系统能够从数据中学习并自动改进，而无需显式编程。",
        "talkingPoints": [
          "机器学习是人工智能的一个子集，专注于模式识别",
          "ML系统通过经验而非手动编写规则来改进",
          "全球ML市场预计到2029年将达到2090亿美元"
        ],
        "visualGuide": "具有未来科技美学的醒目标题幻灯片。从深海军蓝到午夜蓝的渐变背景。居中的大号粗体标题文本，背后有微妙的神经网络节点图案。电蓝色强调光晕。"
      },
      {
        "title": "机器学习的工作原理",
        "mainIdea": "机器学习算法根据从数据中学习的方式分为监督学习、无监督学习和强化学习。",
        "talkingPoints": [
          "监督学习使用标记数据进行分类和回归任务",
          "无监督学习通过聚类在未标记数据中发现隐藏模式",
          "强化学习通过试错和奖励信号优化决策"
        ],
        "visualGuide": "三个不同的视觉部分展示每种ML类型及其代表性图标：监督学习用标记数据对，无监督学习用聚类组，强化学习用类似游戏的奖励循环。使用一致的配色方案：蓝色、绿色和紫色。"
      },
      {
        "title": "商业应用",
        "mainIdea": "各行各业的公司都在利用机器学习在客户体验、运营和决策方面获得竞争优势。",
        "talkingPoints": [
          "客户流失预测通过早期识别风险账户减少收入损失",
          "欺诈检测系统实时处理数百万笔交易",
          "个性化推荐引擎显著提高参与度和销售额"
        ],
        "visualGuide": "左对齐文本和右侧图标或迷你图表的简洁内容布局。白色背景配以微妙的网格线。每个关键点都有一个小型说明性图标（欺诈用盾牌，预测用图表，个性化用用户图标）。"
      },
      {
        "title": "开始使用机器学习",
        "mainIdea": "成功的ML采用需要从清晰的用例、高质量数据和合适的团队开始，而不是直接跳转到复杂算法。",
        "talkingPoints": [
          "识别预测或自动化能带来明确价值的高影响力用例",
          "在选择算法之前投资于干净、结构良好的数据",
          "建立或与ML专业知识合作，并从成熟的框架开始"
        ],
        "visualGuide": "带有编号路线图或步骤布局的结论幻灯片。三个大号编号圆圈（1、2、3），每个包含一个步骤。背景带有暗示进展的微妙向上箭头。最终步骤使用醒目的强调色，营造行动号召感。"
      }
    ]
  },
  "theme": "midnight_tech",
  "stream": false
}

以编程方式获取模式

GET /api/v1/docs/outline-format
Authorization: Bearer {PREZENTIT_API_KEY}

返回包含所有约束和示例幻灯片的完整JSON模式。

错误处理

错误响应格式

{
  "error": "人类可读消息",
  "code": "错误代码",
  "fix": "解决此问题的指导"
}

常见错误及解决方案

处理积分不足

{
  "error": "积分不足",
  "code": "INSUFFICIENT_CREDITS",
  "required": 75,
  "available": 50,
  "purchaseUrl": "https://prezentit.net/buy-credits"
}

AI代理响应： "您需要75积分，但只有50积分。请在 https://prezentit.net/buy-credits 购买更多积分。"

处理部分生成

如果用户有一些积分但不足以完成完整生成，API将返回带有选项的 confirmation_required 响应。读取 _ai.options 数组并将其呈现给用户。要继续进行部分生成，请重新发送带有 "confirmPartial": true 的请求。

处理速率限制

{
  "error": "请求过多",
  "code": "RATE_LIMITED",
  "retryAfter": 30
}

AI代理操作： 等待 retryAfter 秒后重试。

附加端点

检查生成状态

GET /api/v1/me/generation/status
Authorization: Bearer {PREZENTIT_API_KEY}

如果生成正在进行，则返回当前进度：阶段、百分比、已完成的设计。

取消正在进行的生成

POST /api/v1/me/generation/cancel
Authorization: Bearer {PREZENTIT_API_KEY}

取消当前正在进行的生成。

获取演示文稿详情

```http
GET /api/v1/p