展开本页目录
开始前准备什么
- 解压lesson.zip到独立目录，先阅读README与运行范围。
- 使用与页面一致的工具版本；模型或账户能力以自己实际权限为准。
- 保留原始输入；教材中的人工参考与模型实际结果分开保存。
- 选定一套API文档
- 按受众构造两份请求
- 对照schema再提交
- 限制轮询与重试
- 下载终态产物
- 验证两份演示的差异
- 留存请求与恢复点
含README、原创输入、提示词、校验脚本与明确标注的参考材料。
audiences.json，原创练习数据或任务书。
具体步骤、命令与未执行范围。
1. 选定一套API文档
本页使用自托管v1异步任务思路，Cloud v3的认证和schema不同。先从自己版本的OpenAPI导出请求schema；素材中的beginners-request.json与volunteers-request.json是本地构造草稿，不冒充跨版本通用可用请求。
bash
python3 verify.py
2. 按受众构造两份请求
分别读beginners与volunteers，生成3页和4页任务。核对60分钟、12台设备、4名志愿者没有因受众变化而改写；用request-builder.py把事实和提示写入本地请求草稿。
bash
python3 request-builder.py
3. 对照schema再提交
自托管创建端点为POST /api/v1/ppt/presentation/generate/async，状态端点为GET /api/v1/ppt/presentation/status/{id}。工作流指南与旧v0.9.7-beta参考的认证示例分别出现Bearer和Basic；使用自己部署OpenAPI的完整Authorization值，不混用Cloud key。响应顶层id落盘后再轮询。
bash
curl --fail-with-body --request POST "$PRESENTON_BASE_URL/api/v1/ppt/presentation/generate/async" --header "Authorization: $PRESENTON_AUTHORIZATION_HEADER" --header "Content-Type: application/json" --data-binary @beginners-request.json4. 限制轮询与重试
使用poll-example.py轮询明确的自托管状态URL。终态completed保存产物数据，error保存实际错误并退出；pending继续等待。设置间隔与超时，请求可能已受理时不自动重新创建任务。认证从PRESENTON_AUTHORIZATION_HEADER读取完整值。
bash
python3 poll-example.py --url "$PRESENTON_BASE_URL/api/v1/ppt/presentation/status/$TASK_ID" --success completed --failure error5. 下载终态产物
仅在自己版本定义的成功终态出现时下载结果URL。下载路径和任务映射按受众分别保存；确认文件是PPTX而不是JSON错误页。
6. 验证两份演示的差异
新手版讲课程准备，志愿者版讲值班分工；保留不同页数和同一事实。用verify.py对实际文件检查ZIP结构，再逐页打开检查受众内容。
bash
python3 verify.py --pptx beginners.pptx
7. 留存请求与恢复点
保存两份请求、状态日志和实际文件。素材里只有可离线运行的请求构造器及人工参考，不包含真实模型结果；未执行API时不要把草稿说成批量任务成功。
怎样确认已经完成
- 自己的实际产物能打开，数字、标签、单位与原始输入一致。
- 执行随包verify.py检查真实文件；参考材料不能冒充自己的模型运行。
- 已真实生成两份本地请求草稿并校验事实；未提交Presenton API，未产生真实任务ID或模型输出。
常见问题
下载素材后能直接看到AI生成结果吗？
已真实生成两份本地请求草稿并校验事实；未提交Presenton API，未产生真实任务ID或模型输出。
Presenton API异步生成要怎样判断完成？
按本页步骤执行自己的工具环境，核对原始输入、实际产物与检查清单；下载成功、程序启动或参考文件存在都不能代替实际结果验收。