办公及个人场景化PPT制作

概述

浩瀚 AI PPT Generation

将主题、资料或大纲整理为 PPT 生成任务，并等待任务完成后返回可下载结果。

重要规则

1. 只有用户明确要求生成、重做或修改 PPT 时才调用本 Skill。
2. 绝不把 API Key 写入 Skill 文件、公开代码、截图或日志。API Key 从环境变量 AI_CENTER_API_KEY 读取。
3. API 地址固定为 https://sykaibi.cn。不要擅自改用其他域名。
4. 每个新任务必须生成新的 Idempotency-Key。同一任务重试时必须复用原幂等键。
5. 创建成功后必须保存返回的 presentation_id，并轮询到 completed 或 failed。任务运行中不得声称已经完成。
6. 生成失败、额度不足、鉴权失败、超时或下载失败时，必须如实告知用户具体原因。
7. 默认使用 theme=light 和 use_logo=false。只有用户明确要求时才使用品牌色或账户 Logo。
8. 用户提供真实业务资料时，优先建议脱敏后再提交。

免费试用

若未配置 AI_CENTER_API_KEY，告诉用户可在以下页面领取一次性显示的专属试用 Key：

https://sykaibi.cn/ai-center/app/?source=skillhub

操作：打开页面，点击“领取 SkillHub 试用 Key”，选择免费试生成一份，复制 Key 后将其配置为 AI_CENTER_API_KEY。不要索取或复述完整 Key。每位新用户仅有 1 份免费额度，生成成功才扣除。

支持场景

• project_report：项目汇报，包含目标、当前状态、关键进展、风险与问题、资源需求、下周计划
• class_presentation：课堂展示
• thesis_defense：毕业答辩
• general：通用演示

参数整理

从用户需求提取：topic、scene、pages、audience、outline、reference_text、theme、style、tone、density。

如果用户没有指定页数，使用场景默认值。页数必须在 6 到 40 页之间。outline 必须是字符串，可用换行分隔，不能传数组。大纲内容放在 outline；补充资料才放在 reference_text。

调用流程

1. 查询额度

$base = $env:AI_CENTER_URL
if (-not $base) { $base = "https://sykaibi.cn" }
$headers = @{ "X-API-Key" = $env:AI_CENTER_API_KEY }
Invoke-RestMethod -Uri "$base/v1/account" -Headers $headers -Method Get

2. 创建任务

$idem = "workbuddy-" + [guid]::NewGuid().ToString("N")
$body = @{
  topic = "用户提供的 PPT 主题"
  scene = "project_report"
  pages = 12
  theme = "light"
  use_logo = $false
  outline = "项目目标与范围`n当前状态`n关键进展`n风险与问题`n资源需求`n下周计划"
  reference_text = "用户提供的脱敏资料"
} | ConvertTo-Json -Depth 8
$postHeaders = @{
  "X-API-Key" = $env:AI_CENTER_API_KEY
  "Idempotency-Key" = $idem
  "Content-Type" = "application/json"
}
$created = Invoke-RestMethod -Uri "$base/v1/presentations" -Method Post -Headers $postHeaders -Body $body
$presentationId = $created.presentation_id

创建接口正常返回 HTTP 202。没有 presentation_id 时停止并报告错误。

3. 轮询状态

do {
  Start-Sleep -Seconds 10
  $status = Invoke-RestMethod -Uri "$base/v1/presentations/$presentationId" -Headers $headers -Method Get
  $status | Select-Object presentation_id,status,stage,error
} while ($status.status -eq "running")

4. 交付结果

状态为 completed 时，从返回的 files 中取得 pptx、pdf、preview、script，项目汇报还可取得 action_items。

下载时继续使用同一个 X-API-Key。必须直接使用 API 响应中的 URL，并在需要时以 https://sykaibi.cn 拼接相对路径；不要根据 presentation_id 自行拼接、添加或删除 ppt_ 前缀。

状态为 failed 时，只报告 error 和建议的下一步，不伪造下载链接。

失败处理

• 401：提示检查 AI_CENTER_API_KEY；若尚未领取，引导至免费试用页面
• 402 或额度不足：提示购买额度或联系产品方，不重复提交
• 409：同一幂等键对应了不同参数；新任务需换新幂等键
• 429：等待后重试，不连续刷接口
• 5xx：如已有 presentation_id，保留并稍后继续查询，不立即重复创建
• 轮询超时：如实说明当前状态，保留任务编号供继续查询