QUICKROUTER / PRACTICAL WORKBOOK

Presenton API异步生成

已真实生成两份本地请求草稿并校验事实;未提交Presenton API,未产生真实任务ID或模型输出。

具体操作与命令

1. 选定一套API文档
python3 verify.py

2. 按受众构造两份请求
python3 request-builder.py

3. 对照schema再提交
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.json

4. 限制轮询与重试
python3 poll-example.py --url "$PRESENTON_BASE_URL/api/v1/ppt/presentation/status/$TASK_ID" --success completed --failure error

5. 下载终态产物
仅在自己版本定义的成功终态出现时下载结果URL。下载路径和任务映射按受众分别保存;确认文件是PPTX而不是JSON错误页。

6. 验证两份演示的差异
python3 verify.py --pptx beginners.pptx

7. 留存请求与恢复点
保存两份请求、状态日志和实际文件。素材里只有可离线运行的请求构造器及人工参考,不包含真实模型结果;未执行API时不要把草稿说成批量任务成功。

2026-10-14 · 本页展示具体练习文件与核对依据;不伪造第三方软件界面或模型执行记录。